ros666/trap/
context.rs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
//! 陷入上下文模块。

use core::arch::asm;

/// 陷入上下文
///
/// 用于保存和恢复陷入处理程序的上下文。
pub struct TrapCtx {
    /// 通用寄存器
    pub x: [usize; 32],
    /// Supervisor 状态寄存器
    pub sstatus: usize,
    /// Supervisor 异常程序计数器                 
    pub sepc: usize,
    /// 内核页表基址 (Supervisor Address Translation and Protection)
    pub kernel_satp: usize,
    /// 内核虚拟栈指针
    pub kernel_virt_sp: usize,
    /// 内核虚拟陷入处理程序入口地址
    pub kernel_virt_trap_handler: usize,
}

impl TrapCtx {
    /// 设置栈指针寄存器的值。
    pub fn set_sp(&mut self, sp: usize) {
        *self.sp() = sp;
    }

    /// 创建一个新的 TrapCtx,用于应用程序上下文。
    ///
    /// ## 参数
    /// - `entry`:程序入口地址。
    /// - `sp`:栈指针地址。
    /// - `kernel_satp`:内核页表基址寄存器的值。
    /// - `kernel_virt_sp`:内核虚拟栈指针的值。
    /// - `kernel_virt_trap_handler`:内核虚拟陷入处理程序的地址。
    /// ## 返回值
    /// 返回一个初始化的 TrapCtx 实例。
    pub fn init_app_context(
        entry: usize,
        sp: usize,
        kernel_satp: usize,
        kernel_virt_sp: usize,
        kernel_virt_trap_handler: usize,
    ) -> Self {
        // the riscv crate does not provide a way to get bits from sstatus
        // so we have to use inline assembly
        let mut sstatus: usize;
        unsafe {
            asm!("csrr {}, sstatus", out(reg) sstatus);
        }
        // 清除 FS 位
        sstatus &= !(1 << 8);
        let mut ctx = Self {
            x: [0; 32],
            sstatus: sstatus,
            sepc: entry,
            kernel_satp,
            kernel_virt_sp,
            kernel_virt_trap_handler,
        };
        ctx.set_sp(sp);
        ctx
    }
}

/// 提供 RISC-V 64 位寄存器的别名。
///
/// 该 trait 定义了访问和修改 RISC-V 64 位架构中各种寄存器的方法。
/// 每个方法返回一个 `usize` 的可变引用,表示寄存器的值。
#[allow(unused)]
pub trait Riscv64RegAlias {
    /// 返回零寄存器(x0)的可变引用,其值始终为 0。
    fn zero(&mut self) -> &mut usize;

    /// 返回返回地址寄存器(ra)的可变引用。
    fn ra(&mut self) -> &mut usize;

    /// 返回栈指针寄存器(x2)的可变引用。
    fn sp(&mut self) -> &mut usize;

    /// 返回全局指针寄存器(gp)的可变引用。
    fn gp(&mut self) -> &mut usize;

    /// 返回线程指针寄存器(tp)的可变引用。
    fn tp(&mut self) -> &mut usize;

    /// 返回一个临时寄存器(t0-t6)的可变引用。
    ///
    /// ## 参数
    /// - `i`:临时寄存器的索引(0-6)。
    fn t(&mut self, i: usize) -> &mut usize;

    /// 返回一个保存寄存器(s0-s11)的可变引用。
    ///
    /// ## 参数
    /// - `i`:保存寄存器的索引(0-11)。
    fn s(&mut self, i: usize) -> &mut usize;

    /// 返回一个参数寄存器(a0-a7)的可变引用。
    ///
    /// ## 参数
    /// - `i`:参数寄存器的索引(0-7)。
    fn a(&mut self, i: usize) -> &mut usize;

    /// 返回一个可变引用,指向监管者异常程序计数器(sepc)。
    fn sepc(&mut self) -> &mut usize;

    /// 返回一个可变引用,指向监管者状态寄存器(sstatus)。
    fn sstatus(&mut self) -> &mut usize;
}

impl Riscv64RegAlias for TrapCtx {
    fn zero(&mut self) -> &mut usize {
        &mut self.x[0]
    }
    fn ra(&mut self) -> &mut usize {
        &mut self.x[1]
    }
    fn sp(&mut self) -> &mut usize {
        &mut self.x[2]
    }
    fn gp(&mut self) -> &mut usize {
        &mut self.x[3]
    }
    fn tp(&mut self) -> &mut usize {
        &mut self.x[4]
    }
    fn t(&mut self, i: usize) -> &mut usize {
        &mut self.x[5 + i]
    }
    fn s(&mut self, i: usize) -> &mut usize {
        &mut self.x[13 + i]
    }
    fn a(&mut self, i: usize) -> &mut usize {
        &mut self.x[10 + i]
    }
    fn sepc(&mut self) -> &mut usize {
        &mut self.sepc
    }
    fn sstatus(&mut self) -> &mut usize {
        &mut self.sstatus
    }
}