riscv: add initial RPMI virt support
Subsystems (2)
cover riscv: add initial RPMI virt support
Add optional librpmi support and the initial RISC-V virt RPMI implementation. This series introduces the shared-memory transport, FDT helpers, opt-in virt wiring, and the Base, System Reset, HSM, and System Suspend service groups with qtest and functional coverage.
The implementation targets the RISC-V Platform Management Interface (RPMI) Specification v1.0 Ratified and uses librpmi as the backend.
Subrahmanya Lingappa (10):
build: add optional librpmi dependency hw/misc: add RISC-V RPMI transport and Base support hw/riscv: add RPMI FDT helpers hw/riscv/virt: add opt-in RPMI base support
riscv: add RPMI system reset service
riscv: add RPMI HSM service
riscv: add RPMI system suspend service docs/system/riscv: document initial virt RPMI support tests/qtest: cover initial RISC-V RPMI services tests/functional: add initial RPMI virt guest smoke
Kconfig.host | 3 + MAINTAINERS | 3 + docs/system/riscv/virt.rst | 50 ++ hw/misc/Kconfig | 4 + hw/misc/meson.build | 6 + hw/misc/riscv_rpmi.c | 558 +++++++++++++++++ hw/misc/riscv_rpmi_hsm.c | 287 +++++++++ hw/misc/riscv_rpmi_internal.h | 42 ++ hw/misc/riscv_rpmi_sysreset.c | 206 +++++++ hw/misc/riscv_rpmi_syssusp.c | 191 ++++++ hw/riscv/Kconfig | 1 + hw/riscv/meson.build | 1 + hw/riscv/rpmi-fdt.c | 103 ++++ hw/riscv/virt.c | 167 +++++ include/hw/misc/riscv_rpmi.h | 126 ++++ include/hw/riscv/rpmi-fdt.h | 41 ++ include/hw/riscv/virt.h | 3 + meson.build | 14 + meson_options.txt | 2 + scripts/meson-buildoptions.sh | 3 + tests/functional/riscv64/meson.build | 2 + tests/functional/riscv64/test_rpmi_virt.py | 172 ++++++ tests/qtest/meson.build | 2 + tests/qtest/riscv-rpmi-test.c | 684 +++++++++++++++++++++ 24 files changed, 2671 insertions(+) create mode 100644 hw/misc/riscv_rpmi.c create mode 100644 hw/misc/riscv_rpmi_hsm.c create mode 100644 hw/misc/riscv_rpmi_internal.h create mode 100644 hw/misc/riscv_rpmi_sysreset.c create mode 100644 hw/misc/riscv_rpmi_syssusp.c create mode 100644 hw/riscv/rpmi-fdt.c create mode 100644 include/hw/misc/riscv_rpmi.h create mode 100644 include/hw/riscv/rpmi-fdt.h create mode 100644 tests/functional/riscv64/test_rpmi_virt.py create mode 100644 tests/qtest/riscv-rpmi-test.c
Signature · 1 line
2.43.0
PATCH 1/10 build: add optional librpmi dependency
From: Subrahmanya Lingappa <[email protected]>
Add a meson option and config probe for librpmi so RISC-V machines can opt into RPMI support when the library is available. Keep the dependency optional so default builds without librpmi continue to work.
--- Kconfig.host | 3 +++ meson.build | 14 ++++++++++++++ meson_options.txt | 2 ++ scripts/meson-buildoptions.sh | 3 +++ 4 files changed, 22 insertions(+)
Kconfig.host +3 -0
@@ -8,6 +8,9 @@ config LINUX config LIBCBOR bool +config LIBRPMI + bool + config GNUTLS bool
meson.build +14 -0
@@ -2005,6 +2005,17 @@ if lzo.found() and not cc.links(''' endif endif +librpmi = not_found +if not get_option('librpmi').auto() or have_system + librpmi = dependency('librpmi', required: get_option('librpmi'), + method: 'pkg-config') + if librpmi.found() and not cc.has_header_symbol('librpmi.h', + 'rpmi_service_group_logging_create', + dependencies: librpmi) + error('librpmi support requires the RPMI logging service group API') + endif +endif + numa = not_found if not get_option('numa').auto() or have_system or have_tools numa = cc.find_library('numa', has_headers: ['numa.h'],
@@ -2427,6 +2438,7 @@ config_host_data.set('CONFIG_LINUX', host_os == 'linux') config_host_data.set('CONFIG_POSIX', host_os != 'windows') config_host_data.set('CONFIG_WIN32', host_os == 'windows') config_host_data.set('CONFIG_LZO', lzo.found()) +config_host_data.set('CONFIG_LIBRPMI', librpmi.found()) config_host_data.set('CONFIG_MPATH', mpathpersist.found()) config_host_data.set('CONFIG_BLKIO', blkio.found()) if blkio.found()
@@ -3258,6 +3270,7 @@ host_kconfig = \ (multiprocess_allowed ? ['CONFIG_MULTIPROCESS_ALLOWED=y'] : []) + \ (vfio_user_server_allowed ? ['CONFIG_VFIO_USER_SERVER_ALLOWED=y'] : []) + \ (hv_balloon ? ['CONFIG_HV_BALLOON_POSSIBLE=y'] : []) + \ + (librpmi.found() ? ['CONFIG_LIBRPMI=y'] : []) + \ (have_rust ? ['CONFIG_HAVE_RUST=y'] : []) ignored = [ 'TARGET_XML_FILES', 'TARGET_ABI_DIR' ]
@@ -4971,6 +4984,7 @@ summary_info += {'TPM support': have_tpm} summary_info += {'IGVM support': igvm} summary_info += {'libssh support': libssh} summary_info += {'lzo support': lzo} +summary_info += {'librpmi support': librpmi} summary_info += {'snappy support': snappy} summary_info += {'bzip2 support': libbzip2} summary_info += {'lzfse support': liblzfse}
meson_options.txt +2 -0
@@ -204,6 +204,8 @@ option('lzfse', type : 'feature', value : 'auto', description: 'lzfse support for DMG images') option('lzo', type : 'feature', value : 'auto', description: 'lzo compression support') +option('librpmi', type : 'feature', value : 'auto', + description: 'RISC-V RPMI support') option('pvg', type: 'feature', value: 'auto', description: 'macOS paravirtualized graphics support') option('rbd', type : 'feature', value : 'auto',
scripts/meson-buildoptions.sh +3 -0
@@ -140,6 +140,7 @@ meson_options_help() { printf "%s\n" ' libkeyutils Linux keyutils support' printf "%s\n" ' libnfs libnfs block device driver' printf "%s\n" ' libpmem libpmem support' + printf "%s\n" ' librpmi RISC-V RPMI support' printf "%s\n" ' libssh ssh block device support' printf "%s\n" ' libudev Use libudev to enumerate host devices' printf "%s\n" ' libusb libusb support for USB passthrough'
@@ -376,6 +377,8 @@ _meson_option_parse() { --disable-libnfs) printf "%s" -Dlibnfs=disabled ;; --enable-libpmem) printf "%s" -Dlibpmem=enabled ;; --disable-libpmem) printf "%s" -Dlibpmem=disabled ;; + --enable-librpmi) printf "%s" -Dlibrpmi=enabled ;; + --disable-librpmi) printf "%s" -Dlibrpmi=disabled ;; --enable-libssh) printf "%s" -Dlibssh=enabled ;; --disable-libssh) printf "%s" -Dlibssh=disabled ;; --enable-libudev) printf "%s" -Dlibudev=enabled ;;
Signature · 1 line
2.43.0
PATCH 2/10 hw/misc: add RISC-V RPMI transport and Base support
In reply to Subrahmanya LingappaFrom: Subrahmanya Lingappa <[email protected]>
RPMI (RISC-V Platform Management Interface) is the RISC-V non-ISA platform management specification. It defines a shared-memory transport, message protocol, and service groups for platform management.
Add the QEMU transport backend and Base service plumbing for virt using librpmi.
This implementation targets the RISC-V Platform Management Interface (RPMI) Specification v1.0 Ratified:
https://github.com/riscv-non-isa/riscv-rpmi/releases/download/v1.0/riscv-rpmi.pdf
The librpmi backend is maintained at:
https://github.com/riscv-software-src/librpmi
--- MAINTAINERS | 2 + hw/misc/Kconfig | 4 + hw/misc/meson.build | 3 + hw/misc/riscv_rpmi.c | 476 ++++++++++++++++++++++++++++++++++ hw/misc/riscv_rpmi_internal.h | 24 ++ include/hw/misc/riscv_rpmi.h | 90 +++++++ 6 files changed, 599 insertions(+) create mode 100644 hw/misc/riscv_rpmi.c create mode 100644 hw/misc/riscv_rpmi_internal.h create mode 100644 include/hw/misc/riscv_rpmi.h
MAINTAINERS +2 -0
@@ -359,6 +359,8 @@ F: target/riscv/ F: hw/char/riscv_htif.c F: hw/riscv/ F: hw/intc/riscv* +F: hw/misc/riscv_rpmi* +F: include/hw/misc/riscv_rpmi.h F: include/hw/char/riscv_htif.h F: include/hw/riscv/ F: common-user/host/riscv*
hw/misc/Kconfig +4 -0
@@ -258,3 +258,7 @@ config XLNX_ZYNQ_DDRC bool source macio/Kconfig + +config RISCV_RPMI + bool + depends on LIBRPMI
hw/misc/meson.build +3 -0
@@ -168,3 +168,6 @@ system_ss.add(when: 'CONFIG_SBSA_REF', if_true: files('sbsa_ec.c')) # HPPA devices system_ss.add(when: 'CONFIG_LASI', if_true: files('lasi.c')) +system_ss.add(when: 'CONFIG_RISCV_RPMI', if_true: [files( + 'riscv_rpmi.c', +), librpmi])
hw/misc/riscv_rpmi.c new file +476 -0
476 lines not on this page · raw message
hw/misc/riscv_rpmi_internal.h new file +24 -0
@@ -0,0 +1,24 @@ +/* +* SPDX-License-Identifier: GPL-2.0-or-later +* +* RISC-V RPMI internal service helpers. +* +* Copyright (c) 2026 Qualcomm Technologies, Inc. +* Author: +* Subrahmanya Lingappa <[email protected]> +*/ + +#ifndef HW_MISC_RISCV_RPMI_INTERNAL_H +#define HW_MISC_RISCV_RPMI_INTERNAL_H + +#include "qapi/error.h" +#include "hw/misc/riscv_rpmi.h" +#include "librpmi.h" + +#define RPMI_PLAT_INFO "QEMU RISC-V RPMI" + +extern const struct rpmi_shmem_platform_ops rpmi_shmem_qemu_ops; +bool riscv_rpmi_service_enabled (RiscvRpmiState *s, +RiscvRpmiServiceKind kind); + +#endif
include/hw/misc/riscv_rpmi.h new file +90 -0
90 lines not on this page · raw message
Signature · 1 line
2.43.0
PATCH 3/10 hw/riscv: add RPMI FDT helpers
In reply to Subrahmanya LingappaFrom: Subrahmanya Lingappa <[email protected]>
Add helper routines for describing RPMI shared-memory mailbox transports and service child nodes in the RISC-V virt device tree.
The helpers keep RPMI node construction in one place so the virt machine can add service groups without open-coding compatible strings, channel IDs, interrupts, and shared-memory references at each call site.
--- hw/riscv/meson.build | 1 + hw/riscv/rpmi-fdt.c | 103 ++++++++++++++++++++++++++++++++++++ include/hw/riscv/rpmi-fdt.h | 30 +++++++++++ 3 files changed, 134 insertions(+) create mode 100644 hw/riscv/rpmi-fdt.c create mode 100644 include/hw/riscv/rpmi-fdt.h
hw/riscv/meson.build +1 -0
@@ -3,6 +3,7 @@ riscv_ss.add(files('boot.c')) riscv_ss.add(files('fdt-common.c')) riscv_ss.add(when: 'CONFIG_RISCV_NUMA', if_true: files('numa.c')) riscv_ss.add(files('riscv_hart.c')) +riscv_ss.add(files('rpmi-fdt.c')) riscv_ss.add(when: 'CONFIG_OPENTITAN', if_true: files('opentitan.c')) riscv_ss.add(when: 'CONFIG_RISCV_VIRT', if_true: files('virt.c')) riscv_ss.add(when: 'CONFIG_SHAKTI_C', if_true: files('shakti_c.c'))
hw/riscv/rpmi-fdt.c new file +103 -0
103 lines not on this page · raw message
include/hw/riscv/rpmi-fdt.h new file +30 -0
@@ -0,0 +1,30 @@ +/* +* SPDX-License-Identifier: GPL-2.0-or-later +* +* RISC-V RPMI device-tree helpers +* +* Copyright (c) 2026 Qualcomm Technologies, Inc. +* Author: +* Subrahmanya Lingappa <[email protected]> +*/ + +#ifndef HW_RISCV_RPMI_FDT_H +#define HW_RISCV_RPMI_FDT_H + +#include "exec/hwaddr.h" +#include "hw/misc/riscv_rpmi.h" + +typedef struct RiscvRpmiFdtMboxConfig { +hwaddr shmem_base; +hwaddr doorbell_base; +uint32_t a2p_req_size; +uint32_t p2a_req_size; +uint32_t doorbell_size; +}RiscvRpmiFdtMboxConfig ; + +void riscv_rpmi_fdt_add_mbox (void *fdt, +const RiscvRpmiFdtMboxConfig *cfg, +uint32_t *phandle, +uint32_t *mbox_handle); + +#endif
Signature · 1 line
2.43.0
PATCH 4/10 hw/riscv/virt: add opt-in RPMI base support
In reply to Subrahmanya LingappaFrom: Subrahmanya Lingappa <[email protected]>
Add the virt machine rpmi=on/off option and wire the initial RPMI Base transport into machine realization.
The option remains disabled by default and requires TCG plus librpmi. Invalid accelerator/build combinations fail during machine initialization. When enabled, virt allocates the RPMI shared-memory transport, creates the RPMI device, configures Base service metadata, and emits the corresponding device-tree nodes for firmware discovery.
--- hw/riscv/Kconfig | 1 + hw/riscv/virt.c | 96 ++++++++++++++++++++++++++++++++++++ include/hw/misc/riscv_rpmi.h | 10 ++++ include/hw/riscv/virt.h | 3 ++ 4 files changed, 110 insertions(+)
hw/riscv/Kconfig +1 -0
@@ -49,6 +49,7 @@ config RISCV_VIRT imply VIRTIO_VGA imply TEST_DEVICES imply TPM_TIS_SYSBUS + imply RISCV_RPMI select DEVICE_TREE select RISCV_NUMA select GOLDFISH_RTC
hw/riscv/virt.c +96 -0
150 lines not on this page · raw message
include/hw/misc/riscv_rpmi.h +10 -0
@@ -85,6 +85,16 @@ struct RiscvRpmiState { bool has_shmem; }; +#ifdef CONFIG_LIBRPMI DeviceState *riscv_rpmi_create (const RiscvRpmiConfig *cfg,Error **errp); +#else +static inline DeviceState *riscv_rpmi_create (const RiscvRpmiConfig *cfg, +Error **errp) +{ + (void )cfg; + (void )errp; +return NULL ; +} +#endif #endif
include/hw/riscv/virt.h +3 -0
@@ -55,6 +55,7 @@ struct RISCVVirtState {int fdt_size;bool have_aclint; +bool have_rpmi;RISCVVirtAIAType aia_type;int aia_guests;char *oem_id;
@@ -79,6 +80,8 @@ enum {VIRT_UART0 ,VIRT_VIRTIO ,VIRT_FW_CFG , +VIRT_RPMI_SHMEM , +VIRT_RPMI_DOORBELL ,VIRT_IMSIC_M ,VIRT_IMSIC_S , VIRT_FLASH,
Signature · 1 line
2.43.0
PATCH 5/10 riscv: add RPMI system reset service
In reply to Subrahmanya LingappaFrom: Subrahmanya Lingappa <[email protected]>
Add a QEMU implementation of the RPMI System Reset service group.
The service advertises shutdown and cold reboot reset types, validates guest requests, and dispatches accepted requests through the machine reset and shutdown callbacks. This lets firmware use RPMI reset commands while keeping the board-specific reset policy in the RISC-V virt machine.
--- hw/misc/meson.build | 1 + hw/misc/riscv_rpmi.c | 38 ++++++- hw/misc/riscv_rpmi_internal.h | 9 ++ hw/misc/riscv_rpmi_sysreset.c | 206 ++++++++++++++++++++++++++++++++++ hw/riscv/virt.c | 40 +++++++ include/hw/misc/riscv_rpmi.h | 13 ++- include/hw/riscv/rpmi-fdt.h | 11 ++ 7 files changed, 313 insertions(+), 5 deletions(-) create mode 100644 hw/misc/riscv_rpmi_sysreset.c
hw/misc/meson.build +1 -0
@@ -170,4 +170,5 @@ system_ss.add(when: 'CONFIG_SBSA_REF', if_true: files('sbsa_ec.c')) system_ss.add(when: 'CONFIG_LASI', if_true: files('lasi.c')) system_ss.add(when: 'CONFIG_RISCV_RPMI', if_true: [files( 'riscv_rpmi.c', + 'riscv_rpmi_sysreset.c', ), librpmi])
hw/misc/riscv_rpmi.c +35 -3
@@ -175,6 +175,8 @@ static void riscv_rpmi_configure_base(RiscvRpmiState *s, const RiscvRpmiConfig *cfg) { s->platform_info =g_strdup (cfg->platform_info); + s->machine_ops = cfg->machine_ops; + s->machine_opaque = cfg->machine_opaque; s->services = cfg->services; s->service_count = cfg->service_count;
@@ -211,7 +213,9 @@ static void riscv_rpmi_reset(DeviceState *dev)static void riscv_rpmi_cleanup (RiscvRpmiState *s) { - +for (uint32_t i =ARRAY_SIZE (riscv_rpmi_service_ops); i >0 ; i--) { + riscv_rpmi_service_ops[i -1 ].remove (s); + }if (s->context) {rpmi_context_destroy (s->context);
@@ -247,6 +251,30 @@ bool riscv_rpmi_service_enabled(RiscvRpmiState *s, RiscvRpmiServiceKind kind)return false; } +bool riscv_rpmi_context_add_group (RiscvRpmiState *s, +struct rpmi_service_group *group, +const char *name, +Error **errp) +{ +enum rpmi_error rc; + + rc =rpmi_context_add_group (s->context, group); +if (rc !=RPMI_SUCCESS ) { +error_setg (errp,"failed to add RPMI %s service group: %d" , name, rc); +return false; + } + +return true; +} + +void riscv_rpmi_context_remove_group (RiscvRpmiState *s, +struct rpmi_service_group *group) +{ +if (s->context && group) { +rpmi_context_remove_group (s->context, group); + } +} +static bool riscv_rpmi_validate_config (RiscvRpmiState *s,Error **errp) {uint64_t queue_bytes;
@@ -318,11 +346,15 @@ static bool riscv_rpmi_add_service_group(RiscvRpmiState *s,const RiscvRpmiServiceConfig *service, Error **errp) { - switch (service->kind) { - default: + const RiscvRpmiServiceOps *ops; + + ops =riscv_rpmi_service_ops_by_kind (service->kind); +if (!ops) {error_setg (errp,"unsupported RPMI service kind %d" , service->kind);return false; } + +return ops->add (s, errp); }static bool riscv_rpmi_init_services (RiscvRpmiState *s,Error **errp)
hw/misc/riscv_rpmi_internal.h +9 -0
@@ -20,5 +20,14 @@extern const struct rpmi_shmem_platform_ops rpmi_shmem_qemu_ops;bool riscv_rpmi_service_enabled (RiscvRpmiState *s,RiscvRpmiServiceKind kind); +bool riscv_rpmi_context_add_group (RiscvRpmiState *s, +struct rpmi_service_group *group, +const char *name, +Error **errp); +void riscv_rpmi_context_remove_group (RiscvRpmiState *s, +struct rpmi_service_group *group); + +bool riscv_rpmi_sysreset_add (RiscvRpmiState *s,Error **errp); +void riscv_rpmi_sysreset_remove (RiscvRpmiState *s);#endif
hw/misc/riscv_rpmi_sysreset.c new file +206 -0
206 lines not on this page · raw message
hw/riscv/virt.c +40 -0
@@ -1007,6 +1007,35 @@ static void create_fdt_iommu(RISCVVirtState *s, uint16_t bdf) } +static const RiscvRpmiServiceConfig virt_rpmi_services[] = { + { + .kind =RISCV_RPMI_SERVICE_SYSRESET , + .node_name ="sysreset" , + .compatible ="riscv,rpmi-system-reset" , + .service_group =RISCV_RPMI_SRVGRP_SYSTEM_RESET , + }, +}; + +static uint32_t virt_rpmi_service_count (RISCVVirtState *s) +{ +return ARRAY_SIZE (virt_rpmi_services); +} + +static void virt_rpmi_system_reset (void *opaque) +{ +qemu_system_reset_request (SHUTDOWN_CAUSE_GUEST_RESET ); +} + +static void virt_rpmi_system_shutdown (void *opaque) +{ +qemu_system_shutdown_request (SHUTDOWN_CAUSE_GUEST_SHUTDOWN ); +} + +static const RiscvRpmiMachineOps virt_rpmi_machine_ops = { + .system_reset = virt_rpmi_system_reset, + .system_shutdown = virt_rpmi_system_shutdown, +}; +static RiscvRpmiConfig virt_rpmi_config (RISCVVirtState *s,const uint32_t *hart_ids,uint32_t hart_count)
@@ -1018,8 +1047,12 @@ static RiscvRpmiConfig virt_rpmi_config(RISCVVirtState *s, .a2p_req_size = VIRT_RPMI_A2P_REQ_SIZE, .p2a_req_size = VIRT_RPMI_P2A_REQ_SIZE, .platform_info = "QEMU RISC-V virt RPMI", + .machine_ops = &virt_rpmi_machine_ops, + .machine_opaque = s, .hart_ids = hart_ids, .hart_count = hart_count, + .services = virt_rpmi_services, + .service_count = virt_rpmi_service_count(s), }; }
@@ -1028,6 +1061,7 @@ static void create_fdt_rpmi(RISCVVirtState *s, uint32_t *phandle, {RiscvRpmiConfig rpmi_cfg =virt_rpmi_config (s,NULL ,0 );uint32_t rpmi_mbox_handle; +uint32_t i;RiscvRpmiFdtMboxConfig cfg = { .shmem_base = rpmi_cfg.shmem_base, .doorbell_base = rpmi_cfg.doorbell_base,
@@ -1038,6 +1072,12 @@ static void create_fdt_rpmi(RISCVVirtState *s, uint32_t *phandle,riscv_rpmi_fdt_add_mbox (MACHINE (s)->fdt, &cfg, phandle, &rpmi_mbox_handle); + +for (i =0 ; i < rpmi_cfg.service_count; i++) { +riscv_rpmi_fdt_add_service_node (MACHINE (s)->fdt, rpmi_cfg.shmem_base, + &rpmi_cfg.services[i], + rpmi_mbox_handle); + } }static void finalize_fdt (RISCVVirtState *s)
include/hw/misc/riscv_rpmi.h +11 -2
@@ -27,6 +27,7 @@#define VIRT_RPMI_A2P_REQ_SIZE (16 * RPMI_QUEUE_SLOT_SIZE)#define VIRT_RPMI_P2A_REQ_SIZE 0 +#define RISCV_RPMI_SRVGRP_SYSTEM_RESET 3#define TYPE_RISCV_RPMI "riscv-rpmi"OBJECT_DECLARE_SIMPLE_TYPE (RiscvRpmiState,RISCV_RPMI )
@@ -38,8 +39,13 @@ struct rpmi_transport;typedef enum RiscvRpmiServiceKind {RISCV_RPMI_SERVICE_INVALID =0 , +RISCV_RPMI_SERVICE_SYSRESET , }RiscvRpmiServiceKind ; +typedef struct RiscvRpmiMachineOps { +void (*system_reset)(void *opaque); +void (*system_shutdown)(void *opaque); +}RiscvRpmiMachineOps ; typedef struct RiscvRpmiServiceConfig { RiscvRpmiServiceKind kind; const char *node_name;
@@ -56,7 +62,8 @@ typedef struct RiscvRpmiConfig {uint32_t a2p_req_size;uint32_t p2a_req_size;const char *platform_info; - +const RiscvRpmiMachineOps *machine_ops; +void *machine_opaque;const uint32_t *hart_ids;uint32_t hart_count;const RiscvRpmiServiceConfig *services;
@@ -73,7 +80,9 @@ struct RiscvRpmiState {uint32_t a2p_req_size;uint32_t p2a_req_size;char *platform_info; - +const RiscvRpmiMachineOps *machine_ops; +void *machine_opaque; +struct rpmi_service_group *sysreset_group;uint32_t *hart_ids;uint32_t hart_count;const RiscvRpmiServiceConfig *services;
include/hw/riscv/rpmi-fdt.h +11 -0
@@ -26,5 +26,16 @@ void riscv_rpmi_fdt_add_mbox(void *fdt,const RiscvRpmiFdtMboxConfig *cfg, uint32_t *phandle, uint32_t *mbox_handle); +void riscv_rpmi_fdt_add_service (void *fdt,hwaddr shmem_base, +const char *node_name, +const char *compatible, +uint32_t mbox_handle, +uint32_t service_group, +bool has_mpxy_channel, +uint32_t mpxy_channel); + +void riscv_rpmi_fdt_add_service_node (void *fdt,hwaddr shmem_base, +const RiscvRpmiServiceConfig *service, +uint32_t mbox_handle);#endif
Signature · 1 line
2.43.0
PATCH 6/10 riscv: add RPMI HSM service
In reply to Subrahmanya LingappaFrom: Subrahmanya Lingappa <[email protected]>
Add the RPMI Hart State Management service group for RISC-V virt.
The service exposes the configured virt hart IDs to librpmi and keeps per-hart RPMI hardware state in the RPMI device. Start, stop, and suspend requests update QEMU CPU halted state and resume/kick vCPUs as needed so firmware can exercise RPMI HSM operations against the emulated topology.
--- hw/misc/meson.build | 1 + hw/misc/riscv_rpmi.c | 46 ++++++ hw/misc/riscv_rpmi_hsm.c | 280 ++++++++++++++++++++++++++++++++++ hw/misc/riscv_rpmi_internal.h | 4 + hw/riscv/virt.c | 6 + include/hw/misc/riscv_rpmi.h | 6 + 6 files changed, 343 insertions(+) create mode 100644 hw/misc/riscv_rpmi_hsm.c
hw/misc/meson.build +1 -0
@@ -171,4 +171,5 @@ system_ss.add(when: 'CONFIG_LASI', if_true: files('lasi.c')) system_ss.add(when: 'CONFIG_RISCV_RPMI', if_true: [files( 'riscv_rpmi.c', 'riscv_rpmi_sysreset.c', + 'riscv_rpmi_hsm.c', ), librpmi])
hw/misc/riscv_rpmi.c +46 -0
64 lines not on this page · raw message
hw/misc/riscv_rpmi_hsm.c new file +280 -0
280 lines not on this page · raw message
hw/misc/riscv_rpmi_internal.h +4 -0
@@ -30,4 +30,8 @@ void riscv_rpmi_context_remove_group(RiscvRpmiState *s,bool riscv_rpmi_sysreset_add (RiscvRpmiState *s,Error **errp);void riscv_rpmi_sysreset_remove (RiscvRpmiState *s); +bool riscv_rpmi_hsm_add (RiscvRpmiState *s,Error **errp); +void riscv_rpmi_hsm_remove (RiscvRpmiState *s); +void riscv_rpmi_hsm_reset (RiscvRpmiState *s); +#endif
hw/riscv/virt.c +6 -0
@@ -1014,6 +1014,12 @@ static const RiscvRpmiServiceConfig virt_rpmi_services[] = { .compatible = "riscv,rpmi-system-reset", .service_group = RISCV_RPMI_SRVGRP_SYSTEM_RESET, }, + { + .kind = RISCV_RPMI_SERVICE_HSM, + .node_name = "hsm", + .compatible = "riscv,rpmi-hsm", + .service_group = RISCV_RPMI_SRVGRP_HSM, + }, };static uint32_t virt_rpmi_service_count (RISCVVirtState *s)
include/hw/misc/riscv_rpmi.h +6 -0
@@ -28,6 +28,7 @@#define VIRT_RPMI_P2A_REQ_SIZE 0#define RISCV_RPMI_SRVGRP_SYSTEM_RESET 3 +#define RISCV_RPMI_SRVGRP_HSM 5#define TYPE_RISCV_RPMI "riscv-rpmi"OBJECT_DECLARE_SIMPLE_TYPE (RiscvRpmiState,RISCV_RPMI )
@@ -36,10 +37,12 @@ struct rpmi_context;struct rpmi_service_group ;struct rpmi_shmem ;struct rpmi_transport ; +struct rpmi_hsm ;typedef enum RiscvRpmiServiceKind {RISCV_RPMI_SERVICE_INVALID =0 ,RISCV_RPMI_SERVICE_SYSRESET , +RISCV_RPMI_SERVICE_HSM , }RiscvRpmiServiceKind ; typedef struct RiscvRpmiMachineOps {
@@ -83,6 +86,9 @@ struct RiscvRpmiState {const RiscvRpmiMachineOps *machine_ops;void *machine_opaque;struct rpmi_service_group *sysreset_group; +struct rpmi_hsm *hsm; +struct rpmi_service_group *hsm_group; +uint32_t *hsm_hw_states;uint32_t *hart_ids;uint32_t hart_count;const RiscvRpmiServiceConfig *services;
Signature · 1 line
2.43.0
PATCH 7/10 riscv: add RPMI system suspend service
In reply to Subrahmanya LingappaFrom: Subrahmanya Lingappa <[email protected]>
Add the RPMI System Suspend service group for RISC-V virt.
The service advertises suspend-to-RAM support through librpmi, registers QEMU wakeup support, and routes the suspend finalize callback to the machine suspend path. On wakeup it processes RPMI group events and defers the HSM hart resume until vCPUs are ready to run again.
--- hw/misc/meson.build | 1 + hw/misc/riscv_rpmi.c | 4 + hw/misc/riscv_rpmi_hsm.c | 9 +- hw/misc/riscv_rpmi_internal.h | 5 + hw/misc/riscv_rpmi_syssusp.c | 191 ++++++++++++++++++++++++++++++++++ hw/riscv/virt.c | 25 +++++ include/hw/misc/riscv_rpmi.h | 11 ++ 7 files changed, 245 insertions(+), 1 deletion(-) create mode 100644 hw/misc/riscv_rpmi_syssusp.c
hw/misc/meson.build +1 -0
@@ -172,4 +172,5 @@ system_ss.add(when: 'CONFIG_RISCV_RPMI', if_true: [files( 'riscv_rpmi.c', 'riscv_rpmi_sysreset.c', 'riscv_rpmi_hsm.c', + 'riscv_rpmi_syssusp.c', ), librpmi])
hw/misc/riscv_rpmi.c +4 -0
@@ -187,6 +187,10 @@ static const RiscvRpmiServiceOps riscv_rpmi_service_ops[] = { .kind = RISCV_RPMI_SERVICE_HSM, .add = riscv_rpmi_hsm_add, .remove = riscv_rpmi_hsm_remove, + }, { + .kind = RISCV_RPMI_SERVICE_SYSSUSP, + .add = riscv_rpmi_syssusp_add, + .remove = riscv_rpmi_syssusp_remove, }, };
hw/misc/riscv_rpmi_hsm.c +8 -1
@@ -235,7 +235,6 @@ static void riscv_rpmi_hsm_destroy(RiscvRpmiState *s)g_clear_pointer (&s->hsm_hw_states, g_free); } -bool riscv_rpmi_hsm_add (RiscvRpmiState *s,Error **errp) {struct rpmi_service_group *group;
@@ -278,3 +277,11 @@ void riscv_rpmi_hsm_reset(RiscvRpmiState *s)rpmi_hsm_process_state_changes (s->hsm); } } + +void riscv_rpmi_hsm_resume (RiscvRpmiState *s,uint32_t hart_index) +{ +riscv_rpmi_hsm_set_hw_state (s, hart_index,RPMI_HART_HW_STATE_STARTED ); +if (s->hsm) { +rpmi_hsm_process_state_changes (s->hsm); + } +}
hw/misc/riscv_rpmi_internal.h +5 -0
@@ -33,5 +33,10 @@ void riscv_rpmi_sysreset_remove(RiscvRpmiState *s);bool riscv_rpmi_hsm_add (RiscvRpmiState *s,Error **errp);void riscv_rpmi_hsm_remove (RiscvRpmiState *s);void riscv_rpmi_hsm_reset (RiscvRpmiState *s); +void riscv_rpmi_hsm_resume (RiscvRpmiState *s,uint32_t hart_index); + +bool riscv_rpmi_syssusp_add (RiscvRpmiState *s,Error **errp); +void riscv_rpmi_syssusp_remove (RiscvRpmiState *s); +#endif
hw/misc/riscv_rpmi_syssusp.c new file +191 -0
191 lines not on this page · raw message
hw/riscv/virt.c +25 -0
@@ -51,6 +51,7 @@#include "chardev/char.h" #include "system/device_tree.h" #include "system/system.h" +#include "system/runstate.h" #include "system/tcg.h" #include "system/kvm.h" #include "system/tpm.h"
@@ -1020,6 +1021,12 @@ static const RiscvRpmiServiceConfig virt_rpmi_services[] = { .compatible = "riscv,rpmi-hsm", .service_group = RISCV_RPMI_SRVGRP_HSM, }, + { + .kind = RISCV_RPMI_SERVICE_SYSSUSP, + .node_name = "suspend", + .compatible = "riscv,rpmi-system-suspend", + .service_group = RISCV_RPMI_SRVGRP_SYSTEM_SUSPEND, + }, };static uint32_t virt_rpmi_service_count (RISCVVirtState *s)
@@ -1037,9 +1044,27 @@ static void virt_rpmi_system_shutdown(void *opaque)qemu_system_shutdown_request (SHUTDOWN_CAUSE_GUEST_SHUTDOWN ); } +static void virt_rpmi_system_suspend (void *opaque) +{ +qemu_system_suspend_request (); +} + +static void virt_rpmi_register_wakeup_support (void *opaque) +{ +qemu_register_wakeup_support (); +} + +static bool virt_rpmi_system_can_resume (void *opaque) +{ +return runstate_check (RUN_STATE_RUNNING ); +} +static const RiscvRpmiMachineOps virt_rpmi_machine_ops = { .system_reset = virt_rpmi_system_reset, .system_shutdown = virt_rpmi_system_shutdown, + .system_suspend = virt_rpmi_system_suspend, + .register_wakeup_support = virt_rpmi_register_wakeup_support, + .system_can_resume = virt_rpmi_system_can_resume, }; static RiscvRpmiConfig virt_rpmi_config(RISCVVirtState *s,
include/hw/misc/riscv_rpmi.h +11 -0
@@ -29,6 +29,7 @@#define RISCV_RPMI_SRVGRP_SYSTEM_RESET 3#define RISCV_RPMI_SRVGRP_HSM 5 +#define RISCV_RPMI_SRVGRP_SYSTEM_SUSPEND 4#define TYPE_RISCV_RPMI "riscv-rpmi"OBJECT_DECLARE_SIMPLE_TYPE (RiscvRpmiState,RISCV_RPMI )
@@ -43,11 +44,15 @@ typedef enum RiscvRpmiServiceKind {RISCV_RPMI_SERVICE_INVALID =0 ,RISCV_RPMI_SERVICE_SYSRESET ,RISCV_RPMI_SERVICE_HSM , +RISCV_RPMI_SERVICE_SYSSUSP , } RiscvRpmiServiceKind;typedef struct RiscvRpmiMachineOps {void (*system_reset)(void *opaque);void (*system_shutdown)(void *opaque); +void (*system_suspend)(void *opaque); +void (*register_wakeup_support)(void *opaque); +bool (*system_can_resume)(void *opaque); }RiscvRpmiMachineOps ; typedef struct RiscvRpmiServiceConfig { RiscvRpmiServiceKind kind;
@@ -86,9 +91,15 @@ struct RiscvRpmiState {const RiscvRpmiMachineOps *machine_ops;void *machine_opaque;struct rpmi_service_group *sysreset_group; +struct rpmi_service_group *syssusp_group;struct rpmi_hsm *hsm;struct rpmi_service_group *hsm_group;uint32_t *hsm_hw_states; +Notifier wakeup_notifier; +bool wakeup_notifier_registered; +QEMUTimer *wakeup_timer; +bool syssusp_resume_pending; +uint32_t syssusp_resume_hart_index;uint32_t *hart_ids;uint32_t hart_count;const RiscvRpmiServiceConfig *services;
Signature · 1 line
2.43.0
PATCH 8/10 docs/system/riscv: document initial virt RPMI support
In reply to Subrahmanya LingappaFrom: Subrahmanya Lingappa <[email protected]>
Document the opt-in virt RPMI transport and the initial HSM, system reset, and system suspend service groups.
--- docs/system/riscv/virt.rst | 50 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+)
docs/system/riscv/virt.rst +50 -0
@@ -146,6 +146,56 @@ The following machine-specific options are supported: Enables the riscv-iommu-sys platform device. Defaults to 'off'. +- rpmi=[on|off] + + Enables the RISC-V RPMI shared-memory transport. This option defaults to + "off", is TCG-only, and is available only when QEMU is built with librpmi + support. This support targets the RISC-V Platform Management Interface + (RPMI) Specification v1.0 Ratified (`RPMI v1.0 specification`_). The initial + ``virt`` implementation exposes RPMI system reset, system suspend, and HSM + service groups. System reset can request shutdown or cold reboot through + RPMI. HSM uses the ``virt`` hart IDs and supports hart discovery, status, + start, stop, and suspend commands. System suspend uses QEMU's suspend and + wakeup path. Migration is currently blocked while RPMI transport and service + VMState support is being designed. + + The build dependency is provided by `librpmi`_. Install librpmi so that + ``pkg-config`` can find ``librpmi.pc``, then configure QEMU with + ``--enable-librpmi`` or ``-Dlibrpmi=enabled``. + +.. _RPMI v1.0 specification: https://github.com/riscv-non-isa/riscv-rpmi/releases/download/v1.0/riscv-rpmi.pdf +.. _librpmi: https://github.com/riscv-software-src/librpmi + +RPMI firmware and guest smoke +----------------------------- + +A firmware-level RPMI smoke test can be run with OpenSBI, a Linux kernel, and a +RISC-V disk image: + +.. code-block:: bash + + $ qemu-system-riscv64 \ + -machine virt,rpmi=on \ + -cpu rv64 -smp 4 -m 4G -nographic \ + -bios /path/to/fw_jump.bin \ + -kernel /path/to/Image \ + -append "root=/dev/vda rw console=ttyS0 earlycon=sbi" \ + -drive file=/path/to/rootfs.img,format=raw,if=virtio,snapshot=on + +The OpenSBI banner should report RPMI-backed HSM and system suspend support. +After the guest reaches a shell, normal guest reboot/poweroff commands exercise +the RPMI system reset path. + +RPMI device tree policy +----------------------- + +RPMI is currently described through FDT only; no ACPI representation is emitted +for the RPMI transport or service groups. The ``virt`` machine uses the +``riscv,rpmi-shmem-mbox`` shared-memory mailbox node plus child service nodes +with ``riscv,rpmi-*`` compatible strings. These binding names are part of the +RPMI RFC surface and may be revised if the RISC-V RPMI bindings change during +review. + Running Linux kernel --------------------
Signature · 1 line
2.43.0
PATCH 9/10 tests/qtest: cover initial RISC-V RPMI services
In reply to Subrahmanya LingappaFrom: Subrahmanya Lingappa <[email protected]>
Add qtests for the RPMI transport plus Base, system reset, HSM, and system suspend service groups.
--- MAINTAINERS | 1 + tests/qtest/meson.build | 2 + tests/qtest/riscv-rpmi-test.c | 684 ++++++++++++++++++++++++++++++++++ 3 files changed, 687 insertions(+) create mode 100644 tests/qtest/riscv-rpmi-test.c
MAINTAINERS +1 -0
@@ -361,6 +361,7 @@ F: hw/riscv/ F: hw/intc/riscv* F: hw/misc/riscv_rpmi* F: include/hw/misc/riscv_rpmi.h +F: tests/qtest/riscv-rpmi-test.c F: include/hw/char/riscv_htif.h F: include/hw/riscv/ F: common-user/host/riscv*
tests/qtest/meson.build +2 -0
@@ -290,6 +290,8 @@ qtests_riscv32 = \ qtests_riscv64 = ['riscv-csr-test'] + \ (unpack_edk2_blobs ? ['bios-tables-test'] : []) + \ + (config_all_devices.has_key('CONFIG_RISCV_RPMI') ? + ['riscv-rpmi-test'] : []) + \ (config_all_devices.has_key('CONFIG_IOMMU_TESTDEV') and config_all_devices.has_key('CONFIG_RISCV_IOMMU') ? ['iommu-riscv-test'] : []) + \
tests/qtest/riscv-rpmi-test.c new file +684 -0
684 lines not on this page · raw message
Signature · 1 line
2.43.0
PATCH 10/10 tests/functional: add initial RPMI virt guest smoke
In reply to Subrahmanya LingappaFrom: Subrahmanya Lingappa <[email protected]>
Boot an RPMI-enabled RISC-V virt guest and exercise the initial HSM, system suspend, and system reset paths.
--- tests/functional/riscv64/meson.build | 2 + tests/functional/riscv64/test_rpmi_virt.py | 172 +++++++++++++++++++++ 2 files changed, 174 insertions(+) create mode 100644 tests/functional/riscv64/test_rpmi_virt.py
tests/functional/riscv64/meson.build +2 -0
@@ -3,6 +3,7 @@ test_riscv64_timeouts = { 'boston' : 120, 'tuxrun' : 120, + 'rpmi_virt' : 300, } tests_riscv64_system_quick = [
@@ -15,4 +16,5 @@ tests_riscv64_system_thorough = [ 'boston', 'sifive_u', 'tuxrun', + 'rpmi_virt', ]
tests/functional/riscv64/test_rpmi_virt.py new file +172 -0
172 lines not on this page · raw message
Signature · 1 line
2.43.0