Add eager FP and RISC-V vector context switching support
cover Add eager FP and RISC-V vector context switching support
Hi,
This patch series adds support for eager floating-point and RISC-V vector context save/restore in OpenSBI.
The goal is to ensure that machine-mode trap handling preserves the full architectural state of lower privilege software (e.g., S-mode), providing correct isolation across trap boundaries.
### Overview
This series introduces:
* Per-hart FP and vector context pointers in sbi_scratch
* FP context save/restore implementation
* RISC-V vector context save/restore implementation
* Integration into the OpenSBI trap handler
### Design
The implementation follows an eager context switching model:
* FP and vector state is saved on every trap entry
* FP and vector state is restored before returning from traps
This ensures correctness and avoids the need for lazy switching or trap-on-first-use mechanisms.
### Context Storage
* FP context:
* f0–f31 registers
* fcsr
* Vector context:
* v0–v31 registers
* vl, vtype, vcsr
Stored per-hart via sbi_scratch.
### Notes / Assumptions
* Assumes FP and vector units are enabled when used (mstatus.FS/VS)
* Assumes RV64 for floating-point implementation (fsd/fld)
* Vector maximum size is bounded by SBI_MAX_VLENB
* Context pointers must be initialized before use
### Performance
This approach introduces additional overhead on every trap due to full state save and restore, especially for vector state, but provides a simple and deterministic model.
### Patch Breakdown
* Patch 1: Add FP context save/restore support
* Patch 2: Add vector context save/restore support
* Patch 3: Extend sbi_scratch with FP/vector context pointers
* Patch 4: Integrate into trap handler
Feedback is welcome, especially regarding:
* CSR restore ordering (vtype/vl/vcsr)
* Trap performance implications
Thanks,
Dave Patel
Signature · 3 lines
opensbi mailing list [email protected] http://lists.infradead.org/mailman/listinfo/opensbi
PATCH 1/4 lib: sbi: domain: ensure boot_hartid is assigned
From: Raymond Mao <[email protected]>
When boot_hartid points to a hart that is not in the domain's assigned hartmask (e.g. due to cold boot hart differences), the domain startup can skip starting the intended boot hart, leading to intermittent Linux boot failures. Scan the assigned hartmask and pick the first available hartid to guarantee a valid boot target.
--- lib/sbi/sbi_domain.c | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+)
lib/sbi/sbi_domain.c +24 -0
@@ -804,6 +804,30 @@ int sbi_domain_startup(struct sbi_scratch *scratch, u32 cold_hartid)/* Startup boot HART of domains */ sbi_domain_for_each (dom) { +u32 boot_hartindex =sbi_hartid_to_hartindex (dom->boot_hartid); +bool boot_assigned = false; + +if (sbi_hartindex_valid (boot_hartindex)) { +spin_lock (&dom->assigned_harts_lock); + boot_assigned =sbi_hartmask_test_hartindex ( + boot_hartindex, &dom->assigned_harts); +spin_unlock (&dom->assigned_harts_lock); + } + +if (!boot_assigned) { +u32 new_hartid =-1U ; + +spin_lock (&dom->assigned_harts_lock); +sbi_hartmask_for_each_hartindex (dhart, &dom->assigned_harts) { + new_hartid =sbi_hartindex_to_hartid (dhart); +break ; + } +spin_unlock (&dom->assigned_harts_lock); + +if (new_hartid !=-1U ) + dom->boot_hartid = new_hartid; + } +/* Domain boot HART index */ dhart =sbi_hartid_to_hartindex (dom->boot_hartid);
Signature · 7 lines
2.43.0 -- opensbi mailing list [email protected] http://lists.infradead.org/mailman/listinfo/opensbi
PATCH 2/4 lib: sbi: Add RISC-V vector context save/restore support (eager switching)
In reply to [email protected]From: Dave Patel <[email protected]>
Add support for saving and restoring RISC-V vector extension state in OpenSBI. This introduces a per-hart vector context structure and helper routines to perform full context save and restore.
The vector context includes vl, vtype, vcsr CSRs along with storage for all 32 vector registers. The register state is saved and restored using byte-wise vector load/store instructions (vse8.v/vle8.v), making the implementation independent of current SEW/LMUL configuration.
The implementation follows an eager context switching model where the entire vector state is saved and restored on every context switch. This provides a simple and deterministic mechanism without requiring lazy trap-based management.
A per-hart pointer is used to track the current vector context owner.
Notes:
- The maximum supported VLEN is capped via SBI_MAX_VLENB.
- The implementation assumes the vector unit is enabled when invoked.
- vstart CSR is not currently saved/restored and is expected to be zero across context switch boundaries.
--- include/sbi/sbi_vector.h | 30 +++++++++ lib/sbi/objects.mk | 1 + lib/sbi/sbi_vector.c | 136 +++++++++++++++++++++++++++++++++++++++ 3 files changed, 167 insertions(+) create mode 100644 include/sbi/sbi_vector.h create mode 100644 lib/sbi/sbi_vector.c
include/sbi/sbi_vector.h new file +30 -0
@@ -0,0 +1,30 @@ +/* SPDX-License-Identifier: GPL-2.0 +* +* Copyright (c) 2026 RISCstar Solutions. +* +* Authors: +* Dave Patel <[email protected]> +*/ + +#ifndef __SBI_VECTOR_H__ +#define __SBI_VECTOR_H__ + +#include <sbi/sbi_types.h> + +#define SBI_MAX_VLENB 256 + +struct sbi_vector_context { +unsigned long vl; +unsigned long vtype; +unsigned long vcsr; + +/* size depends on VLEN */ +uint8_t vregs[32 *SBI_MAX_VLENB ]; +}; + +struct sbi_vector_context *sbi_current_vector_context (void ); +void sbi_vector_save (struct sbi_vector_context *dst); +void sbi_vector_restore (const struct sbi_vector_context *src); + +#endif //__SBI_VECTOR_H__ +
lib/sbi/objects.mk +1 -0
@@ -106,3 +106,4 @@ libsbi-objs-y += sbi_trap_v_ldst.o libsbi-objs-y += sbi_unpriv.o libsbi-objs-y += sbi_expected_trap.o libsbi-objs-y += sbi_cppc.o +libsbi-objs-y += sbi_vector.o
lib/sbi/sbi_vector.c new file +136 -0
136 lines not on this page · raw message
Signature · 7 lines
2.43.0 -- opensbi mailing list [email protected] http://lists.infradead.org/mailman/listinfo/opensbi
PATCH 3/4 lib: sbi: Add floating-point context save/restore support.
In reply to [email protected]From: Dave Patel <[email protected]>
Add support for saving and restoring RISC-V floating-point (F/D) extension state in OpenSBI. This introduces a per-hart floating-point context structure and helper routines to perform full context save and restore.
The floating-point context includes storage for all 32 FPi registers (f0–f31) along with the fcsr control and status register. The register state is saved and restored using double-precision load/store instructions (fsd/fld), assuming an RV64 system with D-extension support.
The implementation follows an eager context switching model where the entire FP state is saved and restored on every context switch. This avoids the need for trap-based lazy management and keeps the design simple and deterministic.
A per-hart pointer is used to track the current floating-point context owner.
Notes:
- The implementation assumes the floating-point unit is enabled (mstatus.FS != Off) when invoked.
- The context layout is fixed to 64-bit FP registers.
--- include/sbi/sbi_fp.h | 22 ++++++++ lib/sbi/objects.mk | 1 + lib/sbi/sbi_fp.c | 117 +++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 140 insertions(+) create mode 100644 include/sbi/sbi_fp.h create mode 100644 lib/sbi/sbi_fp.c
include/sbi/sbi_fp.h new file +22 -0
@@ -0,0 +1,22 @@ +/* SPDX-License-Identifier: GPL-2.0 +* +* Copyright (c) 2026 RISCstar Solutions. +* +* Authors: +* Dave Patel <[email protected]> +*/ + +#ifndef __SBI_FP_H__ +#define __SBI_FP_H__ + +struct sbi_fp_context { +unsigned long f[32 ]; +unsigned long fcsr; +}; + +struct sbi_fp_context *sbi_current_fp_context (void ); +void sbi_fp_save (struct sbi_fp_context *dst); +void sbi_fp_restore (const struct sbi_fp_context *src); + +#endif //__SBI_VECTOR_H__ +
lib/sbi/objects.mk +1 -0
@@ -107,3 +107,4 @@ libsbi-objs-y += sbi_unpriv.o libsbi-objs-y += sbi_expected_trap.o libsbi-objs-y += sbi_cppc.o libsbi-objs-y += sbi_vector.o +libsbi-objs-y += sbi_fp.o
lib/sbi/sbi_fp.c new file +117 -0
117 lines not on this page · raw message
Signature · 7 lines
2.43.0 -- opensbi mailing list [email protected] http://lists.infradead.org/mailman/listinfo/opensbi
PATCH 4/4 include: sbi: scratch: Add per-hart FP and vector context pointers in scratch
In reply to [email protected]From: Dave Patel <[email protected]>
Extend the per-hart sbi_scratch structure to include pointers to floating-point and vector context storage.
This enables tracking of the currently active FP and vector context on a per-hart basis, which is required for eager context switching during trap handling. The scratch structure serves as the central per-hart storage area, making these pointers readily accessible in low-level trap and context switch paths.
The FP and vector context pointers are used by the corresponding save/restore routines to preserve architectural state across traps, ensuring correct isolation between privilege levels.
This change lays the foundation for eager FP and vector context management in OpenSBI.
--- include/sbi/sbi_scratch.h | 5 +++++ 1 file changed, 5 insertions(+)
include/sbi/sbi_scratch.h +5 -0
@@ -54,6 +54,8 @@#ifndef __ASSEMBLER__#include <sbi/sbi_types.h> +#include <sbi/sbi_fp.h> +#include <sbi/sbi_vector.h> /** Representation of per-HART scratch space */ struct sbi_scratch {
@@ -87,6 +89,9 @@ struct sbi_scratch {unsigned long options;/** Index of the hart */ unsigned long hartindex; +/* Current FP/Vector context owner per hart */ +struct sbi_fp_context *fp_ctx; +struct sbi_vector_context *vec_ctx; };/**
Signature · 7 lines
2.43.0 -- opensbi mailing list [email protected] http://lists.infradead.org/mailman/listinfo/opensbi