All of lore.kernel.org
 help / color / mirror / Atom feed
From: Anup Patel <anup@brainfault.org>
To: Peter Maydell <peter.maydell@linaro.org>,
	Palmer Dabbelt <palmer@dabbelt.com>,
	Alistair Francis <Alistair.Francis@wdc.com>,
	Sagar Karandikar <sagark@eecs.berkeley.edu>
Cc: qemu-riscv@nongnu.org, Anup Patel <anup@brainfault.org>,
	qemu-devel@nongnu.org,
	Alistair Francis <alistair.francis@wdc.com>,
	Atish Patra <atishp@atishpatra.org>,
	Bin Meng <bmeng.cn@gmail.com>
Subject: [PATCH v6 22/23] docs/system: riscv: Document AIA options for virt machine
Date: Thu, 30 Dec 2021 18:05:38 +0530	[thread overview]
Message-ID: <20211230123539.52786-23-anup@brainfault.org> (raw)
In-Reply-To: <20211230123539.52786-1-anup@brainfault.org>

From: Anup Patel <anup.patel@wdc.com>

We have two new machine options "aia" and "aia-guests" available
for the RISC-V virt machine so let's document these options.

Signed-off-by: Anup Patel <anup.patel@wdc.com>
Signed-off-by: Anup Patel <anup@brainfault.org>
Reviewed-by: Alistair Francis <alistair.francis@wdc.com>
---
 docs/system/riscv/virt.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/system/riscv/virt.rst b/docs/system/riscv/virt.rst
index fa016584bf..373645513a 100644
--- a/docs/system/riscv/virt.rst
+++ b/docs/system/riscv/virt.rst
@@ -63,6 +63,22 @@ The following machine-specific options are supported:
   When this option is "on", ACLINT devices will be emulated instead of
   SiFive CLINT. When not specified, this option is assumed to be "off".
 
+- aia=[none|aplic|aplic-imsic]
+
+  This option allows selecting interrupt controller defined by the AIA
+  (advanced interrupt architecture) specification. The "aia=aplic" selects
+  APLIC (advanced platform level interrupt controller) to handle wired
+  interrupts whereas the "aia=aplic-imsic" selects APLIC and IMSIC (incoming
+  message signaled interrupt controller) to handle both wired interrupts and
+  MSIs. When not specified, this option is assumed to be "none" which selects
+  SiFive PLIC to handle wired interrupts.
+
+- aia-guests=nnn
+
+  The number of per-HART VS-level AIA IMSIC pages to be emulated for a guest
+  having AIA IMSIC (i.e. "aia=aplic-imsic" selected). When not specified,
+  the default number of per-HART VS-level AIA IMSIC pages is 0.
+
 Running Linux kernel
 --------------------
 
-- 
2.25.1



WARNING: multiple messages have this Message-ID (diff)
From: Anup Patel <anup@brainfault.org>
To: Peter Maydell <peter.maydell@linaro.org>,
	Palmer Dabbelt <palmer@dabbelt.com>,
	Alistair Francis <Alistair.Francis@wdc.com>,
	Sagar Karandikar <sagark@eecs.berkeley.edu>
Cc: Atish Patra <atishp@atishpatra.org>,
	Anup Patel <anup@brainfault.org>, Bin Meng <bmeng.cn@gmail.com>,
	qemu-riscv@nongnu.org, qemu-devel@nongnu.org,
	Alistair Francis <alistair.francis@wdc.com>
Subject: [PATCH v6 22/23] docs/system: riscv: Document AIA options for virt machine
Date: Thu, 30 Dec 2021 18:05:38 +0530	[thread overview]
Message-ID: <20211230123539.52786-23-anup@brainfault.org> (raw)
In-Reply-To: <20211230123539.52786-1-anup@brainfault.org>

From: Anup Patel <anup.patel@wdc.com>

We have two new machine options "aia" and "aia-guests" available
for the RISC-V virt machine so let's document these options.

Signed-off-by: Anup Patel <anup.patel@wdc.com>
Signed-off-by: Anup Patel <anup@brainfault.org>
Reviewed-by: Alistair Francis <alistair.francis@wdc.com>
---
 docs/system/riscv/virt.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/system/riscv/virt.rst b/docs/system/riscv/virt.rst
index fa016584bf..373645513a 100644
--- a/docs/system/riscv/virt.rst
+++ b/docs/system/riscv/virt.rst
@@ -63,6 +63,22 @@ The following machine-specific options are supported:
   When this option is "on", ACLINT devices will be emulated instead of
   SiFive CLINT. When not specified, this option is assumed to be "off".
 
+- aia=[none|aplic|aplic-imsic]
+
+  This option allows selecting interrupt controller defined by the AIA
+  (advanced interrupt architecture) specification. The "aia=aplic" selects
+  APLIC (advanced platform level interrupt controller) to handle wired
+  interrupts whereas the "aia=aplic-imsic" selects APLIC and IMSIC (incoming
+  message signaled interrupt controller) to handle both wired interrupts and
+  MSIs. When not specified, this option is assumed to be "none" which selects
+  SiFive PLIC to handle wired interrupts.
+
+- aia-guests=nnn
+
+  The number of per-HART VS-level AIA IMSIC pages to be emulated for a guest
+  having AIA IMSIC (i.e. "aia=aplic-imsic" selected). When not specified,
+  the default number of per-HART VS-level AIA IMSIC pages is 0.
+
 Running Linux kernel
 --------------------
 
-- 
2.25.1



  parent reply	other threads:[~2021-12-30 13:02 UTC|newest]

Thread overview: 120+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-12-30 12:35 [PATCH v6 00/23] QEMU RISC-V AIA support Anup Patel
2021-12-30 12:35 ` Anup Patel
2021-12-30 12:35 ` [PATCH v6 01/23] target/riscv: Fix trap cause for RV32 HS-mode CSR access from RV64 HS-mode Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-12 12:29   ` Frank Chang
2022-01-12 12:29     ` Frank Chang
2021-12-30 12:35 ` [PATCH v6 02/23] target/riscv: Implement SGEIP bit in hip and hie CSRs Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-13 14:35   ` Frank Chang
2022-01-13 14:35     ` Frank Chang
2021-12-30 12:35 ` [PATCH v6 03/23] target/riscv: Implement hgeie and hgeip CSRs Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-14  6:37   ` Frank Chang
2022-01-14  6:37     ` Frank Chang
2021-12-30 12:35 ` [PATCH v6 04/23] target/riscv: Improve delivery of guest external interrupts Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-13  7:51   ` Frank Chang
2022-01-13  7:51     ` Frank Chang
2021-12-30 12:35 ` [PATCH v6 05/23] target/riscv: Allow setting CPU feature from machine/device emulation Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-12 12:34   ` Frank Chang
2022-01-12 12:34     ` Frank Chang
2021-12-30 12:35 ` [PATCH v6 06/23] target/riscv: Add AIA cpu feature Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-12 12:34   ` Frank Chang
2022-01-12 12:34     ` Frank Chang
2021-12-30 12:35 ` [PATCH v6 07/23] target/riscv: Add defines for AIA CSRs Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-12 12:57   ` Frank Chang
2022-01-12 12:57     ` Frank Chang
2021-12-30 12:35 ` [PATCH v6 08/23] target/riscv: Allow AIA device emulation to set ireg rmw callback Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-12 12:59   ` Frank Chang
2022-01-12 12:59     ` Frank Chang
2021-12-30 12:35 ` [PATCH v6 09/23] target/riscv: Implement AIA local interrupt priorities Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-10 13:08   ` Frank Chang
2022-01-10 13:08     ` Frank Chang
2022-01-11 17:18     ` Anup Patel
2022-01-11 17:18       ` Anup Patel
2022-01-12  3:00       ` Frank Chang
2022-01-12  3:00         ` Frank Chang
2022-01-13 10:45         ` Anup Patel
2022-01-13 10:45           ` Anup Patel
2022-01-13 14:21           ` Frank Chang
2022-01-13 14:21             ` Frank Chang
2022-01-10 13:25   ` Frank Chang
2022-01-10 13:25     ` Frank Chang
2021-12-30 12:35 ` [PATCH v6 10/23] target/riscv: Implement AIA CSRs for 64 local interrupts on RV32 Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-14  9:48   ` Frank Chang
2022-01-14  9:48     ` Frank Chang
2021-12-30 12:35 ` [PATCH v6 11/23] target/riscv: Implement AIA hvictl and hviprioX CSRs Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-12 13:15   ` Frank Chang
2022-01-12 13:15     ` Frank Chang
2022-01-13 10:49     ` Anup Patel
2022-01-13 10:49       ` Anup Patel
2021-12-30 12:35 ` [PATCH v6 12/23] target/riscv: Implement AIA interrupt filtering CSRs Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-11  6:00   ` Frank Chang
2022-01-11  6:00     ` Frank Chang
2021-12-30 12:35 ` [PATCH v6 13/23] target/riscv: Implement AIA mtopi, stopi, and vstopi CSRs Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-12 12:15   ` Frank Chang
2022-01-12 12:15     ` Frank Chang
2022-01-13 10:48     ` Anup Patel
2022-01-13 10:48       ` Anup Patel
2021-12-30 12:35 ` [PATCH v6 14/23] target/riscv: Implement AIA xiselect and xireg CSRs Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-12 16:40   ` Frank Chang
2022-01-12 16:40     ` Frank Chang
2021-12-30 12:35 ` [PATCH v6 15/23] target/riscv: Implement AIA IMSIC interface CSRs Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-05  3:30   ` Frank Chang
2022-01-05  3:30     ` Frank Chang
2022-01-08 12:03     ` Anup Patel
2022-01-08 12:03       ` Anup Patel
2021-12-30 12:35 ` [PATCH v6 16/23] hw/riscv: virt: Use AIA INTC compatible string when available Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-12 16:47   ` Frank Chang
2022-01-12 16:47     ` Frank Chang
2021-12-30 12:35 ` [PATCH v6 17/23] target/riscv: Allow users to force enable AIA CSRs in HART Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-12 13:19   ` Frank Chang
2022-01-12 13:19     ` Frank Chang
2021-12-30 12:35 ` [PATCH v6 18/23] hw/intc: Add RISC-V AIA APLIC device emulation Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-07  8:52   ` Frank Chang
2022-01-07  8:52     ` Frank Chang
2022-01-08 13:28     ` Anup Patel
2022-01-08 13:28       ` Anup Patel
2022-01-08  6:35   ` Frank Chang
2022-01-08  6:35     ` Frank Chang
2022-01-08 12:00     ` Anup Patel
2022-01-08 12:00       ` Anup Patel
2022-01-14 12:02   ` Frank Chang
2022-01-14 12:02     ` Frank Chang
2022-01-14 12:59     ` Anup Patel
2022-01-14 12:59       ` Anup Patel
2021-12-30 12:35 ` [PATCH v6 19/23] hw/riscv: virt: Add optional AIA APLIC support to virt machine Anup Patel
2021-12-30 12:35   ` Anup Patel
2021-12-30 12:35 ` [PATCH v6 20/23] hw/intc: Add RISC-V AIA IMSIC device emulation Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-13  7:26   ` Frank Chang
2022-01-13  7:26     ` Frank Chang
2022-01-13 12:22     ` Anup Patel
2022-01-13 12:22       ` Anup Patel
2021-12-30 12:35 ` [PATCH v6 21/23] hw/riscv: virt: Add optional AIA IMSIC support to virt machine Anup Patel
2021-12-30 12:35   ` Anup Patel
2021-12-30 12:35 ` Anup Patel [this message]
2021-12-30 12:35   ` [PATCH v6 22/23] docs/system: riscv: Document AIA options for " Anup Patel
2022-01-12 13:23   ` Frank Chang
2022-01-12 13:23     ` Frank Chang
2021-12-30 12:35 ` [PATCH v6 23/23] hw/riscv: virt: Increase maximum number of allowed CPUs Anup Patel
2021-12-30 12:35   ` Anup Patel
2022-01-05 21:50   ` Alistair Francis
2022-01-05 21:50     ` Alistair Francis
2022-01-12 13:26   ` Frank Chang
2022-01-12 13:26     ` Frank Chang

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20211230123539.52786-23-anup@brainfault.org \
    --to=anup@brainfault.org \
    --cc=Alistair.Francis@wdc.com \
    --cc=atishp@atishpatra.org \
    --cc=bmeng.cn@gmail.com \
    --cc=palmer@dabbelt.com \
    --cc=peter.maydell@linaro.org \
    --cc=qemu-devel@nongnu.org \
    --cc=qemu-riscv@nongnu.org \
    --cc=sagark@eecs.berkeley.edu \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.