RISC-V内核移植实战：从零开始手把手实现RT-Thread上下文切换（附GD32VF103代码解析）

RISC-V内核移植实战：从零开始手把手实现RT-Thread上下文切换（附GD32VF103代码解析）

如果你是从ARM Cortex-M系列转战RISC-V的嵌入式开发者，第一次接触RT-Thread在RISC-V上的移植，可能会感到一丝困惑。那些在Cortex-M上熟悉的PendSV中断、硬件自动压栈，在RISC-V的世界里似乎都变了模样。我最初在GD32VF103上移植RT-Thread时，就花了整整两天时间才理清RISC-V上下文切换的独特逻辑。今天，我想把这些实战经验系统地分享给你，让你少走弯路，快速掌握RISC-V内核移植的核心技巧。

RISC-V作为一种开放的指令集架构，其设计哲学与ARM有着显著差异。这种差异不仅体现在指令集上，更深入到中断处理、特权模式和上下文切换机制中。对于RTOS移植而言，理解这些差异是成功的关键。本文将以GD32VF103（基于芯来科技Bumblebee内核）为具体案例，深入剖析RT-Thread上下文切换的三种实现方式，并提供可直接复用的汇编代码模板和调试技巧。无论你是正在评估RISC-V平台，还是已经开始了具体的移植工作，这篇文章都将为你提供实用的技术参考。

1. RISC-V与ARM架构在RTOS移植上的关键差异

在开始动手写代码之前，我们必须先理解RISC-V和ARM在RTOS移植层面的本质区别。很多开发者习惯用ARM的思维模式去理解RISC-V，这往往会导致移植过程中的困惑和错误。

最核心的差异在于中断和异常处理模型。在ARM Cortex-M系列中，我们习惯了硬件自动压栈机制——当异常发生时，处理器会自动将PSR、PC、LR、R12、R3-R0等寄存器压入当前堆栈。这种设计简化了RTOS的上下文切换，特别是在使用PendSV进行任务切换时，我们只需要保存剩余的寄存器即可。但RISC-V采取了不同的设计哲学。

RISC-V的中断和异常统称为“陷阱”（trap），处理器在陷入陷阱时不会自动保存任何通用寄存器。所有的现场保存工作都必须由软件完成。这意味着在RISC-V上实现上下文切换时，我们需要保存和恢复的寄存器数量更多，且完全由软件控制。这种设计带来了更大的灵活性，但也增加了移植的复杂度。

另一个重要差异是特权模式和中断使能机制。RISC-V定义了机器模式（M-mode）、监管者模式（S-mode）和用户模式（U-mode）。在嵌入式场景中，我们通常工作在机器模式下。RISC-V的全局中断使能位MIE位于mstatus寄存器的第3位，这与ARM的PRIMASK或FAULTMASK有本质不同。

让我们通过一个简单的对比表格来直观理解这些差异：

注意：RISC-V的x0寄存器被硬连线为0，不需要保存。但在实际保存上下文时，我们通常还是会为x0预留位置以保持栈帧结构的整齐。

理解了这些架构差异后，我们就能更好地设计RISC-V上的上下文切换方案。在RT-Thread的RISC-V移植中，常见的做法是直接进行上下文切换，而不是像ARM那样通过 PendSV 中断来触发。这种选择主要基于两个原因：一是RISC-V没有硬件自动压栈，使用软件中断带来的性能优势不明显；二是直接切换代码更直观，易于调试和维护。

2. RT-Thread libcpu抽象层与移植接口详解

RT-Thread通过libcpu抽象层来屏蔽不同CPU架构的差异，为内核提供统一的接口。理解这个抽象层的设计，是成功移植的关键。libcpu层向上对内核提供标准化的接口，向下则要求我们根据具体CPU架构实现这些接口。

对于RISC-V移植，我们需要实现的核心接口包括以下几个函数和变量：

/* 关闭全局中断，返回之前的中断状态 */
rt_base_t rt_hw_interrupt_disable(void);

/* 恢复全局中断到指定状态 */
void rt_hw_interrupt_enable(rt_base_t level);

/* 初始化线程栈，返回栈顶指针 */
rt_uint8_t *rt_hw_stack_init(void *tentry, void *parameter, 
                             rt_uint8_t *stack_addr, void *texit);

/* 切换到新线程（首次切换，无来源线程） */
void rt_hw_context_switch_to(rt_uint32 to);

/* 线程间的上下文切换 */
void rt_hw_context_switch(rt_uint32 from, rt_uint32 to);

/* 中断中的上下文切换请求 */
void rt_hw_context_switch_interrupt(rt_uint32 from, rt_uint32 to);

/* 上下文切换标志和线程指针 */
rt_uint32_t rt_thread_switch_interrupt_flag;
rt_uint32_t rt_interrupt_from_thread, rt_interrupt_to_thread;

这些接口中，最核心的是三个上下文切换函数，它们分别对应不同的使用场景：

• rt_hw_context_switch_to()：调度器启动第一个线程时调用，只有目标线程，没有来源线程
• rt_hw_context_switch()：普通线程切换，有明确的来源线程和目标线程
• rt_hw_context_switch_interrupt()：在中断处理中请求上下文切换

在RISC-V架构中，这三个函数的实现方式与ARM有显著不同。让我们先看看线程栈帧的结构定义，这是理解上下文切换的基础：

struct rt_hw_stack_frame {
    rt_ubase_t epc;        /* 异常程序计数器 - 保存线程入口地址 */
    rt_ubase_t ra;         /* x1 - 返回地址寄存器 */
    rt_ubase_t mstatus;    /* 机器模式状态寄存器 */
    rt_ubase_t gp;         /* x3 - 全局指针 */
    rt_ubase_t tp;         /* x4 - 线程指针 */
    rt_ubase_t t0;         /* x5 - 临时寄存器0 */
    rt_ubase_t t1;         /* x6 - 临时寄存器1 */
    rt_ubase_t t2;         /* x7 - 临时寄存器2 */
    rt_ubase_t s0_fp;      /* x8 - 保存寄存器0/帧指针 */
    rt_ubase_t s1;         /* x9 - 保存寄存器1 */
    rt_ubase_t a0;         /* x10 - 返回值/参数0 */
    rt_ubase_t a1;         /* x11 - 返回值/参数1 */
    rt_ubase_t a2;         /* x12 - 参数2 */
    rt_ubase_t a3;         /* x13 - 参数3 */
    rt_ubase_t a4;         /* x14 - 参数4 */
    rt_ubase_t a5;         /* x15 - 参数5 */
    rt_ubase_t a6;         /*