vstvec

Supervisor Trap Vector

Controls where traps jump.

Attributes

Defining Extension	H, version >= 0
CSR Address	0x205
Length	64-bit
Privilege Mode	S

Defining Extension

H, version >= 0

CSR Address

0x205

Length

64-bit

Privilege Mode

Format

Figure 1. vstvec format

Field Summary

Name Location Type Reset Value

Name	Location	Type	Reset Value
`BASE`	63:2	RW-R	0
`MODE`	1:0	RW-R	0

BASE

63:2

RW-R

MODE

1:0

RW-R

Fields

`BASE`

Location: 63:2
Description: Bit 63:0 of the virtual address of the exception vector for any trap taken into VS-mode.

If the base address is written with a non-cannonical address (i.e., bits 63:39 do not match bit 38),
the write should be ignored.
Type: RW-R
Reset value: 0

`MODE`

Location: 1:0
Description: Vectoring mode for asynchronous interrupts taken into VS-mode.

0 - Direct, 1 - Vectored

When Direct, all synchronous exceptions and asynchronous interrupts jump to (vstvec.BASE << 2).

When Vectored, asynchronous interrupts jump to (vstvec.BASE << 2 + vscause*4) while synchronous exceptions continue to jump to (vstvec.BASE << 2).
Type: RW-R
Reset value: 0

Software write

This CSR may store a value that is different from what software attempts to write.

When a software write occurs (e.g., through csrrw), the following determines the written value:

BASE = # Base spec says that BASE must be 4-byte aligned, which will always be the case
# implementations may put further constraints on BASE when MODE != Direct
# If that is the case, stvec should have an override for the implementation
return csr_value.BASE;

MODE = if (csr_value.MODE == 0 || csr_value.MODE == 1) {
  return csr_value.MODE;
} else {
  return UNDEFINED_LEGAL_DETERMINISTIC;
}