前期準備
開發環境：ubuntu18.04

驗證示例工程
本次實驗驗證的平臺是PLCT提供的QEMU，在Linux下的QEMU可以使用上述的筆者編譯好的，也可以使用自己嘗試編譯PLCT提供的源碼。

OPENHW提供了基于FreeRTOS的示例工程，由于使用的是PLCT提供的QEMU，所以IDE中自帶的工程并不能直接使用，為了避免不必要的麻煩，本文采用PLCT提供的示例工程。

下載好示例工程,進入到app目錄，執行以下命令配置編譯工程：

source ../env/core-v-mcu.sh

make RISCV=xxx //xxx為工具鏈的路徑

編譯完成后將生成的cli_test可執行文件拷到qemu的安裝目錄，運行下述命令驗證工程;

./qemu-system-riscv32 -M core_v_mcu -bios none -kernel cli_test -nographic -monitor none -serial stdio

運行結果：

出現上述結果，則表示示例工程運行正常，這樣我們就有一個可移植的模板工程，后續移植基于該工程開展。

移植RT-Thread
CV32E40P內核是一個RISC-V架構的內核，移植RTOS不可避免的會涉及到匯編部分的修改，所以在移植前期學習一下RISC-V架構與匯編會產生事半功倍的效果，同樣在一之前需要熟悉CV32E40P的內核資源。

cv32e40p繼承自pulp開源的RI5CY內核，而RI5CY內核的對接代碼在RT-Thread的倉庫libcpu/riscv/rv32m1已經實現，所以以RI5CY中的代碼為基礎，移植cv32e40p的對接代碼。

成功移植RT-Thread有如下幾個關鍵的階段：

節拍定時器正常工作
線程可以正常創建，調度（這步最難，需要前面好多工作來保證）
shell可以正常使用（從這開始就順利多了）
RTOS的最小時間單位是系統節拍，系統正常工作需要節拍定時器的支持，因而以節拍定時器的移植為切入點展開移植。

core-v-mcu.c中放置的是系統初始化，中斷處理相關代碼。其中system_init函數完成了時鐘初始化，串口，I2C等外設的初始化，以及中斷函數的綁定。在文件的開頭可以找到如下一個指針數組：

void (*isr_table[32])(uint32_t);
該數組用于綁定中斷入口函數。

for (int i = 0 ; i < 32 ; i ++){
isr_table[i] = undefined_handler;
handler_count[i] = 0;
}
isr_table[0x7] = timer_irq_handler;
isr_table[0xb] = (void(*)(uint32_t))fc_soc_event_handlzer1;
在system_init函數中我們可以找到上述代碼，瀏覽該文件我們可以知道，timer_irq_handler即系統定時器的中斷入口函數，

在原有FreeRTOS工程中該函數內容如下：

void timer_irq_handler(uint32_t mcause)
{
#warning requires critical section if interrupt nesting is used.
if (xTaskIncrementTick() != 0) {
vTaskSwitchContext();
}
}
該函數實現系統節拍的產生，所以將這里的內容修改為RT-Thread的節拍產生的方式，修改如下：

void timer_irq_handler(uint32_t mcause)
{
#warning requires critical section if interrupt nesting is used.
rt_interrupt_enter();
rt_tick_increase();
rt_interrupt_leaves();
}

涉及到中斷，我們就得考慮系統的中斷的實現方式，中斷一般會分為向量中斷與非向量中斷。RISC-V常在啟動后文件中進行中斷模式的配置。從crt0.S文件可以找到如下代碼：

/* set vector table address /
la a0, __vector_start
or a0, a0, 1 / enable vectored mode (hardcoded anyway for CV32E40P) */
csrw mtvec, a0

RISC-V規范定義中斷、異常的入口地址，以及模式使用mtvec寄存器配置，上述代碼將系統的中斷模式配置為了向量模式，向量模式下，每個函數均包含一個獨立的入口函數用來處理中斷。所以我們切換至寫中斷向量表的文件vector.S,我們可以很明顯的看到一段代碼,從名字就可以看出下面是一張向量表 ：

vector_table:
j freertos_risc_v_trap_handler // irq0
j freertos_risc_v_trap_handler
j freertos_risc_v_trap_handler
j freertos_risc_v_trap_handler // irq3
j freertos_risc_v_trap_handler
j freertos_risc_v_trap_handler
j freertos_risc_v_trap_handler
j freertos_risc_v_trap_handler //ctxt_handler // irq 7 mtime or timer
j freertos_risc_v_trap_handler
j freertos_risc_v_trap_handler
j h7// freertos_risc_v_trap_handler
j freertos_risc_v_trap_handler // irq 11 Machine (event Fifo)
j freertos_risc_v_trap_handler
j freertos_risc_v_trap_handler
j freertos_risc_v_trap_handler
j freertos_risc_v_trap_handler
j freertos_risc_v_trap_handler // IRQ16
j freertos_risc_v_trap_handler // IRQ17
j freertos_risc_v_trap_handler // IRQ18
j freertos_risc_v_trap_handler // IRQ19
j freertos_risc_v_trap_handler // IRQ20
j freertos_risc_v_trap_handler // IRQ21
j freertos_risc_v_trap_handler // IRQ22
j freertos_risc_v_trap_handler // IRQ23
j freertos_risc_v_trap_handler // IRQ24
j freertos_risc_v_trap_handler // IRQ25
j freertos_risc_v_trap_handler // IRQ26
j freertos_risc_v_trap_handler // IRQ27
j freertos_risc_v_trap_handler // IRQ28
j freertos_risc_v_trap_handler // IRQ29
j freertos_risc_v_trap_handler // IRQ30
j freertos_risc_v_trap_handler // IRQ30

PS:上述向量表看的我懵了好久啊，相信對于剛接觸底層不久的小伙伴也會有同樣的感受吧，向量表不是一張多姿多彩的表嗎，怎么感覺都一樣啊？？？不急，我們在看一下core-v-mcu.c這個文件，又會發現一段非常顯眼的代碼：

void vSystemIrqHandler(uint32_t mcause)
{
uint32_t val = 0;
// extern void (*isr_table[32])(uint32_t);
isr_table[mcause & 0x1f](mcause & 0x1f);
}
結合上文，思考一下大致可以明白這個函數的作用了：分發中斷。即所有的異常與中斷觸發后均會執行這個函數，那我們全局搜索一下這個函數，找一下是哪里調用了.全局搜索可以找到如下代碼：

CPPFLAGS += -DportasmHANDLE_INTERRUPT=vSystemIrqHandler
繼續搜索DportasmHANDLE_INTERRUPT可從portASM.S找到如下代碼;

load_x sp, xISRStackTop /* Switch to ISR stack before function call. */
jal portasmHANDLE_INTERRUPT
j processed_source

瀏覽代碼可知，系統觸發中斷或異常后最終均會執行vSystemIrqHandler函數，該函數是在freertos_risc_v_trap_handler函數中被調用，至此我們大致可以明白整個過程了，當中斷或者異常出發后，會查詢向量表，執行freertos_risc_v_trap_handler函數，該函數會調用vSystemIrqHandler，經其分發后最終執行到系統初始化時綁定的中斷入口函數。

在RT-Thread 中由interrupt_gcc.S中的函數實現vSystemIrqHandler函數的調用，所以我們修改中斷向量表的內容如下：

vector_table:
j IRQ_Handler // irq0
j IRQ_Handler
j IRQ_Handler
j IRQ_Handler // irq3
j IRQ_Handler
j IRQ_Handler
j IRQ_Handler
j IRQ_Handler //ctxt_handler // irq 7 mtime or timer
j IRQ_Handler
j IRQ_Handler
j IRQ_Handler // IRQ_Handler
j IRQ_Handler // irq 11 Machine (event Fifo)
j IRQ_Handler
j IRQ_Handler
j IRQ_Handler
j IRQ_Handler
j IRQ_Handler // IRQ16
j IRQ_Handler // IRQ17
j IRQ_Handler // IRQ18
j IRQ_Handler // IRQ19
j IRQ_Handler // IRQ20
j IRQ_Handler // IRQ21
j IRQ_Handler // IRQ22
j IRQ_Handler // IRQ23
j IRQ_Handler // IRQ24
j IRQ_Handler // IRQ25
j IRQ_Handler // IRQ26
j IRQ_Handler // IRQ27
j IRQ_Handler // IRQ28
j IRQ_Handler // IRQ29
j IRQ_Handler // IzRQ30
j IRQ_Handler // IRQ30

瀏覽IRQ_Handler可知，觸發中斷或異常均會執行該代碼，該函數的主要的功能就是實現了軟件保存上下文。根據RISC-V規范可知,RISC-V架構定義不支持硬件壓棧，所以需要軟件實現這部分，這樣做的出發點大概是為了簡化RISC-V架構的內核的設計吧！！！

libcpu/riscv/rv32m1中的IRQ_Handler函數存在如下內容

/* switch to interrupt stack */
la    sp, __stack            // 移植時需修改
/* interrupt handle */
call  rt_interrupt_enter
csrr  a0, mcause
csrr  a1, mepc
mv    a2, sp
call  SystemIrqHandler       // 移植時需修改
call  rt_interrupt_leave

這部分的作用是，加載中斷棧的棧頂地址與執行保存上文之后的工作，這里是調用SystemIrqHandler函數進行中斷分發，修改如下：

/* switch to interrupt stack */
la    sp, __freertos_irq_stack_top //棧頂地址 位于鏈接腳本中 
/* interrupt handle */
call  rt_interrupt_enter
csrr  a0, mcause
csrr  a1, mepc
mv    a2, sp
call  vSystemIrqHandler            // 調用vSystemIrqHandler函數
call  rt_interrupt_leave

在board.c的rt_hw_board_init函數中，添加如下代碼：

vPortSetupTimerInterrupt();//初始化定時器
volatile uint32_t mtvec = 0;
__asm volatile( "csrr %0, mtvec" : "=r"( mtvec ) );//聲明僅有一張向量表
__asm volatile( "csrs mie, %0" :: "r"(0x880) );//使能定時器中斷與外部中斷

至此，基本的移植工作已經完成，可以采用靜態創建任務的方式，實現多任務的創建與調度。

動態內存

在board.c添加下述代碼：

#if defined(RT_USING_USER_MAIN) && defined(RT_USING_HEAP)
#define RT_HEAP_SIZE (64*1024)
static rt_uint8_t rt_heap[RT_HEAP_SIZE];
void *rt_heap_begin_get(void)
{
return rt_heap;
}
void *rt_heap_end_get(void)
{
return rt_heap + RT_HEAP_SIZE;
}
#endif
在rt_hw_board_init添加下述代碼：

#if defined(RT_USING_USER_MAIN) && defined(RT_USING_HEAP)
rt_system_heap_init(rt_heap_begin_get(), rt_heap_end_get());
#endif

完成上述工作便可使用RT-Thread的動態內存相關接口，同樣可以種動態創建線程的函數。

shell

在鏈接腳本的.text段添加如下內容

/* section information for finsh shell */
. = ALIGN(4);
__fsymtab_start = .;
KEEP(*(FSymTab))
__fsymtab_end = .;
. = ALIGN(4);
__vsymtab_start = .;
KEEP(*(VSymTab))
__vsymtab_end = .;
. = ALIGN(4);

實現以下函數：

char rt_hw_console_getchar(void)
{
return udma_uart_getchar(0);
}
void rt_hw_console_output(const char str)
{
writeraw(0, strlen(str), (uint8_t )str);
}
注：writeraw函數來自udma_uart_writeraw，去掉了其中涉及FreeRTOS的API.

完成上述部分便可以使用RT-Thread的shell。

自動初始化
在鏈接腳本的.text段添加如下內容：

/* section information for initial. */
. = ALIGN(4);
__rt_init_start = .;
KEEP(*(SORT(.rti_fn*)))
__rt_init_end = .;
. = ALIGN(4);

添加上述代碼后便可使用RT-Thread的自動初始化接口。

結果驗證

在生成的目標文件的目錄下，輸入運行命令，示例命令：

/home/wangshun/bin/qemu-riscv/bin/qemu-system-riscv32 -M core_v_mcu -bios none -kernel rtthread.elf -nographic -monitor none -serial stdio

使用時，/home/wangshun/bin/qemu-riscv/bin/修改為用戶的qemu的路徑。

運行結果如下：

| /

RT - Thread Operating System
/ | 5.0.0 build Dec 16 2022 11:25:07
2006 - 2022 Copyright by RT-Thread team
Hello RT-Thread
msh >help
RT-Thread shell commands:
finshToCLI - Switch to CLI: CLI component of Core-V-MCU
pin - pin [option]
clear - clear the terminal screen
version - show RT-Thread version information
list - list objects
help - RT-Thread shell help.
ps - List threads in the system.
free - Show the memory usage in the system.
msh >ps
thread pri status sp stack size max used left tick error

tshell 20 running 0x00000160 0x00001000 22% 0x00000009 OK
tidle0 31 ready 0x000000f0 0x00000100 98% 0x1c05e62d OK
timer 4 suspend 0x000000e0 0x00000200 43% 0x00000008 OK
msh >

至此，移植RT-Thread至OPENHW開源的基于CV32E40P內核的CORE-V-MCU便移植完成。

CORE-V-MCU bsp
core-v-mcu的bsp已經合并至RT-Thread的主倉庫，并配有詳細的使用說明，鏈接。

小結

在為RISC-V移植RTOS時，筆者認為要具備RISC-V架構規范與編程規范的基本的了解，磨刀不誤砍柴工嘛，雖然在寫本文時洋洋灑灑寫的很自在，但是在移植的過程中每遇到一個坑就會卡好久，不過也不要妄自菲薄，經過這么一個過程就好很多了,此時不禁讓人感慨“兩岸猿聲啼不住，輕舟已過萬重山”。