On Wed, May 28, 2025 at 4:13 PM Ethan Chen <etha...@andestech.com> wrote:
>
> On Thu, May 22, 2025 at 11:24:28AM +1000, Alistair Francis wrote:
> > [EXTERNAL MAIL]
> >
> > On Wed, Mar 12, 2025 at 7:43 PM Ethan Chen via <qemu-devel@nongnu.org> 
> > wrote:
> > >
> > > - Add 'iopmp=on' option to enable IOPMP. It adds iopmp devices virt 
> > > machine
> > >   to protect all regions of system memory.
> > >
> > > Signed-off-by: Ethan Chen <etha...@andestech.com>
> > > ---
> > >  docs/specs/index.rst       |  1 +
> > >  docs/specs/riscv-iopmp.rst | 60 ++++++++++++++++++++++++++++++
> > >  docs/system/riscv/virt.rst |  9 +++++
> > >  hw/riscv/Kconfig           |  1 +
> > >  hw/riscv/virt.c            | 75 ++++++++++++++++++++++++++++++++++++++
> > >  include/hw/riscv/virt.h    |  3 ++
> > >  6 files changed, 149 insertions(+)
> > >  create mode 100644 docs/specs/riscv-iopmp.rst
> > >
> > > diff --git a/docs/specs/index.rst b/docs/specs/index.rst
> > > index f19d73c9f6..0871c17b8f 100644
> > > --- a/docs/specs/index.rst
> > > +++ b/docs/specs/index.rst
> > > @@ -39,3 +39,4 @@ guest hardware that is specific to QEMU.
> > >     riscv-iommu
> > >     riscv-aia
> > >     aspeed-intc
> > > +   riscv-iopmp
> > > diff --git a/docs/specs/riscv-iopmp.rst b/docs/specs/riscv-iopmp.rst
> > > new file mode 100644
> > > index 0000000000..36a395e552
> > > --- /dev/null
> > > +++ b/docs/specs/riscv-iopmp.rst
> > > @@ -0,0 +1,60 @@
> > > +.. _riscv-iopmp:
> > > +
> > > +RISC-V IOPMP support for RISC-V machines
> > > +========================================
> > > +
> > > +IOPMP support is based on `IOPMP specification version 0.7`_. The device 
> > > is
> > > +available on the RISC-V virt machine but is disabled by default. To 
> > > enable
> > > +iopmp device, use the 'iopmp' machine option
> > > +
> > > +.. code-block:: bash
> > > +
> > > +  $ qemu-system-riscv64 -M virt,iopmp=on
> > > +
> > > +On the virt board, the number of IOPMP device is fixed at 1, and its 
> > > protect
> > > +region is fixed to 0x0~0xFFFFFFFF.
> > > +
> > > +To configure IOPMP device, modify gloal driver property
> > > +
> > > +.. code-block:: bash
> > > +
> > > +  -global driver=riscv_iopmp, property=<property>, value=<value>
> > > +
> > > +Below are the IOPMP device properties and their default values:
> > > +
> > > +- mdcfg_fmt: 1 (Options: 0/1/2)
> > > +- srcmd_fmt: 0 (Options: 0/1/2)
> > > +- tor_en: true (Options: true/false)
> > > +- sps_en: false (Options: true/false)
> > > +- prient_prog: true (Options: true/false)
> > > +- rrid_transl_en: false (Options: true/false)
> > > +- rrid_transl_prog: false (Options: true/false)
> > > +- chk_x: true (Options: true/false)
> > > +- no_x: false (Options: true/false)
> > > +- no_w: false (Options: true/false)
> > > +- stall_en: false (Options: true/false)
> > > +- peis: true (Options: true/false)
> > > +- pees: true (Options: true/false)
> > > +- mfr_en: true (Options: true/false)
> > > +- md_entry_num: 5 (IMP: Valid only for mdcfg_fmt 1/2)
> > > +- md_num: 8 (Range: 0-63)
> > > +- rrid_num: 16 (Range: srcmd_fmt ≠ 2: 0-65535, srcmd_fmt = 2: 0-32)
> > > +- entry_num: 48 (Range: 0-IMP. For mdcfg_fmt = 1,
> > > +  it is fixed as md_num * (md_entry_num + 1).
> > > +  Entry registers must not overlap with other registers.)
> > > +- prio_entry: 65535 (Range: 0-IMP. If prio_entry > entry_num,
> > > +  it will be set to entry_num.)
> > > +- rrid_transl: 0x0 (Range: 0-65535)
> > > +- entry_offset: 0x4000 (IMP: Entry registers must not overlap
> > > +  with other registers.)
> > > +- err_rdata: 0x0 (uint32. Specifies the value used in responses to
> > > +  read transactions when errors are suppressed)
> > > +- msi_en: false (Options: true/false)
> > > +- msidata: 12 (Range: 1-1023)
> > > +- stall_violation_en: true (Options: true/false)
> > > +- err_msiaddr: 0x24000000 (lower-part 32-bit address)
> > > +- err_msiaddrh: 0x0 (higher-part 32-bit address)
> > > +- msi_rrid: 0 (Range: 0-65535. Specifies the rrid used by the IOPMP to 
> > > send
> > > +  the MSI.)
> >
> > I'm not sure this is clear to a user, what are people supposed to do
> > with all these values?
> >
> > Alistair
>
> These parameters are defined by the IOPMP specification and are intended
> for hardware designers. By adjusting these values, designers can modify
> the mapping model between IOPMP tables and rules, configure support for
> specific features, control the response to rule violations, and optimize
> trade-offs such as gate count and latency to meet their design
> objectives.

I think we should say that then

Alistair

>
> QEMU supports user-defined configuration of these parameters to accurately
> replicate the behavior of the target hardware.
>
> Ethan Chen
>
> >
> > > +
> > > +.. _IOPMP specification version 0.7: 
> > > https://github.com/riscv-non-isa/iopmp-spec/releases/download/v0.7/iopmp-v0.7.pdf
> > > diff --git a/docs/system/riscv/virt.rst b/docs/system/riscv/virt.rst
> > > index 60850970ce..77c8d386d5 100644
> > > --- a/docs/system/riscv/virt.rst
> > > +++ b/docs/system/riscv/virt.rst
> > > @@ -146,6 +146,15 @@ The following machine-specific options are supported:
> > >
> > >    Enables the riscv-iommu-sys platform device. Defaults to 'off'.
> > >
> > > +- iopmp=[on|off]
> > > +
> > > +  When this option is "on", IOPMP devices are added to machine. IOPMP 
> > > checks
> > > +  memory transcations in system memory. This option is assumed to be 
> > > "off". To
> > > +  enable the CPU to perform transactions with a specified RRID, use the 
> > > CPU
> > > +  option "-cpu <cpu>,iopmp=true,iopmp_rrid=<rrid>"
> > > +
> > > +  See :ref:`riscv-iopmp` for configurations of IOPMP
> > > +
> > >  Running Linux kernel
> > >  --------------------
> > >
> > > diff --git a/hw/riscv/Kconfig b/hw/riscv/Kconfig
> > > index e6a0ac1fa1..637438af2c 100644
> > > --- a/hw/riscv/Kconfig
> > > +++ b/hw/riscv/Kconfig
> > > @@ -68,6 +68,7 @@ config RISCV_VIRT
> > >      select PLATFORM_BUS
> > >      select ACPI
> > >      select ACPI_PCI
> > > +    select RISCV_IOPMP
> > >
> > >  config SHAKTI_C
> > >      bool
> > > diff --git a/hw/riscv/virt.c b/hw/riscv/virt.c
> > > index dae46f4733..0d62e7786c 100644
> > > --- a/hw/riscv/virt.c
> > > +++ b/hw/riscv/virt.c
> > > @@ -57,6 +57,8 @@
> > >  #include "hw/acpi/aml-build.h"
> > >  #include "qapi/qapi-visit-common.h"
> > >  #include "hw/virtio/virtio-iommu.h"
> > > +#include "hw/misc/riscv_iopmp.h"
> > > +#include "hw/misc/riscv_iopmp_dispatcher.h"
> > >
> > >  /* KVM AIA only supports APLIC MSI. APLIC Wired is always emulated by 
> > > QEMU. */
> > >  static bool virt_use_kvm_aia_aplic_imsic(RISCVVirtAIAType aia_type)
> > > @@ -94,6 +96,7 @@ static const MemMapEntry virt_memmap[] = {
> > >      [VIRT_UART0] =        { 0x10000000,         0x100 },
> > >      [VIRT_VIRTIO] =       { 0x10001000,        0x1000 },
> > >      [VIRT_FW_CFG] =       { 0x10100000,          0x18 },
> > > +    [VIRT_IOPMP] =        { 0x10200000,      0x100000 },
> > >      [VIRT_FLASH] =        { 0x20000000,     0x4000000 },
> > >      [VIRT_IMSIC_M] =      { 0x24000000, VIRT_IMSIC_MAX_SIZE },
> > >      [VIRT_IMSIC_S] =      { 0x28000000, VIRT_IMSIC_MAX_SIZE },
> > > @@ -102,6 +105,11 @@ static const MemMapEntry virt_memmap[] = {
> > >      [VIRT_DRAM] =         { 0x80000000,           0x0 },
> > >  };
> > >
> > > +static const MemMapEntry iopmp_protect_memmap[] = {
> > > +    /* IOPMP protect all regions by default */
> > > +    {0x0, 0xFFFFFFFF},
> > > +};
> > > +
> > >  /* PCIe high mmio is fixed for RV32 */
> > >  #define VIRT32_HIGH_PCIE_MMIO_BASE  0x300000000ULL
> > >  #define VIRT32_HIGH_PCIE_MMIO_SIZE  (4 * GiB)
> > > @@ -1118,6 +1126,24 @@ static void create_fdt_iommu(RISCVVirtState *s, 
> > > uint16_t bdf)
> > >                             bdf + 1, iommu_phandle, bdf + 1, 0xffff - 
> > > bdf);
> > >  }
> > >
> > > +static void create_fdt_iopmp(RISCVVirtState *s, const MemMapEntry 
> > > *memmap,
> > > +                             uint32_t irq_mmio_phandle) {
> > > +    g_autofree char *name = NULL;
> > > +    MachineState *ms = MACHINE(s);
> > > +
> > > +    name = g_strdup_printf("/soc/iopmp@%lx", 
> > > (long)memmap[VIRT_IOPMP].base);
> > > +    qemu_fdt_add_subnode(ms->fdt, name);
> > > +    qemu_fdt_setprop_string(ms->fdt, name, "compatible", "riscv_iopmp");
> > > +    qemu_fdt_setprop_cells(ms->fdt, name, "reg", 0x0, 
> > > memmap[VIRT_IOPMP].base,
> > > +        0x0, memmap[VIRT_IOPMP].size);
> > > +    qemu_fdt_setprop_cell(ms->fdt, name, "interrupt-parent", 
> > > irq_mmio_phandle);
> > > +    if (s->aia_type == VIRT_AIA_TYPE_NONE) {
> > > +        qemu_fdt_setprop_cell(ms->fdt, name, "interrupts", IOPMP_IRQ);
> > > +    } else {
> > > +        qemu_fdt_setprop_cells(ms->fdt, name, "interrupts", IOPMP_IRQ, 
> > > 0x4);
> > > +    }
> > > +}
> > > +
> > >  static void finalize_fdt(RISCVVirtState *s)
> > >  {
> > >      uint32_t phandle = 1, irq_mmio_phandle = 1, msi_pcie_phandle = 1;
> > > @@ -1142,6 +1168,10 @@ static void finalize_fdt(RISCVVirtState *s)
> > >      create_fdt_uart(s, virt_memmap, irq_mmio_phandle);
> > >
> > >      create_fdt_rtc(s, virt_memmap, irq_mmio_phandle);
> > > +
> > > +    if (s->have_iopmp) {
> > > +        create_fdt_iopmp(s, virt_memmap, irq_mmio_phandle);
> > > +    }
> > >  }
> > >
> > >  static void create_fdt(RISCVVirtState *s, const MemMapEntry *memmap)
> > > @@ -1532,6 +1562,8 @@ static void virt_machine_init(MachineState *machine)
> > >      DeviceState *mmio_irqchip, *virtio_irqchip, *pcie_irqchip;
> > >      int i, base_hartid, hart_count;
> > >      int socket_count = riscv_socket_count(machine);
> > > +    DeviceState *iopmp_dev, *iopmp_disp_dev;
> > > +    StreamSink *iopmp_ss, *iopmp_disp_ss;
> > >
> > >      /* Check socket count limit */
> > >      if (VIRT_SOCKETS_MAX < socket_count) {
> > > @@ -1713,6 +1745,29 @@ static void virt_machine_init(MachineState 
> > > *machine)
> > >      }
> > >      virt_flash_map(s, system_memory);
> > >
> > > +    if (s->have_iopmp) {
> > > +        iopmp_dev = iopmp_create(memmap[VIRT_IOPMP].base,
> > > +            qdev_get_gpio_in(DEVICE(mmio_irqchip), IOPMP_IRQ));
> > > +
> > > +        iopmp_setup_system_memory(iopmp_dev, &iopmp_protect_memmap[0], 
> > > 1, 0);
> > > +
> > > +        iopmp_disp_dev = qdev_new(TYPE_RISCV_IOPMP_DISP);
> > > +        qdev_prop_set_uint32(DEVICE(iopmp_disp_dev), "target-num", 1);
> > > +        qdev_prop_set_uint32(DEVICE(iopmp_disp_dev), "stage-num", 1);
> > > +        qdev_realize(DEVICE(iopmp_disp_dev), NULL, &error_fatal);
> > > +
> > > +        /* Add memmap inforamtion to dispatcher */
> > > +        iopmp_ss = (StreamSink 
> > > *)&(RISCV_IOPMP(iopmp_dev)->txn_info_sink);
> > > +        iopmp_dispatcher_add_target(DEVICE(iopmp_disp_dev), iopmp_ss,
> > > +                                    iopmp_protect_memmap[0].base,
> > > +                                    iopmp_protect_memmap[0].size,
> > > +                                    0, 0);
> > > +
> > > +        iopmp_disp_ss =
> > > +            (StreamSink 
> > > *)&(RISCV_IOPMP_DISP(iopmp_disp_dev)->txn_info_sink);
> > > +        iopmp_setup_sink(iopmp_dev, iopmp_disp_ss);
> > > +    }
> > > +
> > >      /* load/create device tree */
> > >      if (machine->dtb) {
> > >          machine->fdt = load_device_tree(machine->dtb, &s->fdt_size);
> > > @@ -1848,6 +1903,20 @@ static void virt_set_iommu_sys(Object *obj, 
> > > Visitor *v, const char *name,
> > >      visit_type_OnOffAuto(v, name, &s->iommu_sys, errp);
> > >  }
> > >
> > > +static bool virt_get_iopmp(Object *obj, Error **errp)
> > > +{
> > > +    RISCVVirtState *s = RISCV_VIRT_MACHINE(obj);
> > > +
> > > +    return s->have_iopmp;
> > > +}
> > > +
> > > +static void virt_set_iopmp(Object *obj, bool value, Error **errp)
> > > +{
> > > +    RISCVVirtState *s = RISCV_VIRT_MACHINE(obj);
> > > +
> > > +    s->have_iopmp = value;
> > > +}
> > > +
> > >  bool virt_is_acpi_enabled(RISCVVirtState *s)
> > >  {
> > >      return s->acpi != ON_OFF_AUTO_OFF;
> > > @@ -1975,6 +2044,12 @@ static void virt_machine_class_init(ObjectClass 
> > > *oc, void *data)
> > >                                NULL, NULL);
> > >      object_class_property_set_description(oc, "iommu-sys",
> > >                                            "Enable IOMMU platform 
> > > device");
> > > +
> > > +    object_class_property_add_bool(oc, "iopmp", virt_get_iopmp,
> > > +                                   virt_set_iopmp);
> > > +    object_class_property_set_description(oc, "iopmp",
> > > +                                          "Set on/off to enable/disable "
> > > +                                          "iopmp device");
> > >  }
> > >
> > >  static const TypeInfo virt_machine_typeinfo = {
> > > diff --git a/include/hw/riscv/virt.h b/include/hw/riscv/virt.h
> > > index 48a14bea2e..cf1e5bd872 100644
> > > --- a/include/hw/riscv/virt.h
> > > +++ b/include/hw/riscv/virt.h
> > > @@ -55,6 +55,7 @@ struct RISCVVirtState {
> > >
> > >      int fdt_size;
> > >      bool have_aclint;
> > > +    bool have_iopmp;
> > >      RISCVVirtAIAType aia_type;
> > >      int aia_guests;
> > >      char *oem_id;
> > > @@ -87,11 +88,13 @@ enum {
> > >      VIRT_PLATFORM_BUS,
> > >      VIRT_PCIE_ECAM,
> > >      VIRT_IOMMU_SYS,
> > > +    VIRT_IOPMP,
> > >  };
> > >
> > >  enum {
> > >      UART0_IRQ = 10,
> > >      RTC_IRQ = 11,
> > > +    IOPMP_IRQ = 12,
> > >      VIRTIO_IRQ = 1, /* 1 to 8 */
> > >      VIRTIO_COUNT = 8,
> > >      PCIE_IRQ = 0x20, /* 32 to 35 */
> > > --
> > > 2.34.1
> > >
> > >

Reply via email to