移植準(zhǔn)備：

軟件平臺：MounRiver Studio（ MRS）;

硬件平臺： CH32V307開發(fā)板；

源碼獲取：https://gitee.com/openharmony/kernel_liteos_m

步驟一：在MRS中新建一個CH32V307的工程，將源碼直接拖到工程中，就添加進來了，然后去添加頭文件路徑即可

源碼中包含比較全面，我們可以選擇不需要的部分將其排除在編譯之外，操作方法為右鍵目錄或文件，點擊Include/Exclude From Build菜單項恢復(fù)編譯，同樣的方法再選一遍即可。

下面說些移植操作系統(tǒng)的注意事項：

ARM上移植實時操作系統(tǒng)大家可能比較熟悉，對于RISC-V內(nèi)核的MCU，可能相對比較陌生。下面結(jié)合WCH的CH32V103和CH32V307兩款芯片來詳細(xì)說下針對RISC-V平臺，移植實時操作系統(tǒng)的注意點。

在移植前，有必要對RISC-V的一些基本知識點有一定的了解，這里對RISC-V的概況，發(fā)展，指令集，特權(quán)模式等不作詳述，僅結(jié)合WCH的RISC-V內(nèi)核的MCU，簡單介紹我們移植實時操作系統(tǒng)有可能遇到的關(guān)鍵點做一下描述。

這里之所以選取V103和V307兩款芯片，主要其極具代表性：

首先，直觀上其外設(shè)的使用方法和我們之前熟悉的F103，F(xiàn)107等是兼容的，這樣降低了我們使用和移植時的難度，基于WCH提供的外設(shè)庫，我們以前上層的代碼甚至于不用修改可直接使用。

其次，V103是WCH RISC-V內(nèi)核家族中的V3內(nèi)核，V307為V4內(nèi)核，V3內(nèi)核支持RV32IMAC指令集，即除支持RISC-V基本的32位整數(shù)指令集外，還支持硬件乘除法，原子指令，壓縮指令。V4在V3的基礎(chǔ)上增加了單精度硬件浮點，并且其性能也比V3高。

除上述之外，雖然兩者的中斷控制器（PFIC）相較于現(xiàn)行的PLIC均不同，均不是統(tǒng)一入口，而是采用中斷向量表尋址的方式，但是V3的中斷向量表處存放是一條指令，而V4的向量表既可以存放指令，也可以存放中斷處理函數(shù)的地址。兩者均支持中斷嵌套和硬件壓棧，區(qū)別在于V3最大嵌套兩級，V4最大可達八級，同時V3的硬件壓棧深度兩級，V4的硬件壓棧深度為三級。這里需要注意的是，移植實時操作系統(tǒng)時需要關(guān)閉硬件壓棧，在切換任務(wù)時所有寄存器，我們希望是由我們自己控制其壓棧和出棧的內(nèi)容。

RISC-V寄存器如下圖所示，其中x0-x31為整形寄存器，f0-f31為浮點寄存器（V3沒有浮點寄存器）。所有帶caller的寄存器，當(dāng)發(fā)生中斷時需要保存，值得注意的是，WCH的硬件壓棧保存的寄存器僅僅保存整數(shù)的16個caller saved 寄存器。正常一個中斷函數(shù)的寄存器保存我們不用關(guān)心，編譯器會幫我們做的很好。但是當(dāng)我們從一個匯編入口進中斷函數(shù)的時候這些過程就不得不由我們自己來實現(xiàn)。寄存器中幾個相對特殊的x0恒為0，x1是返回地址寄存器ra，函數(shù)調(diào)用時用來存放返回地址，x2為堆棧指針sp，x3為gp全局指針，用來尋址全局變量。對于一個正常運行的程序，除了x0，gp兩個初始值固定的外，其余的均會是不確定的，所有在進行上下文保護時，均需要保存。用到硬件浮點的時候，更是要保存32個浮點寄存器。

除了上述的寄存器，移植還要關(guān)心的是幾個csr寄存器mstatus，mepc。正常情況下大部分csr只能在機器模式下操作（WCH的v3和v4內(nèi)核支持機器模式和用戶模式）。mstatus中，MIE為中斷使能，當(dāng)進中斷時MPIE更新為MIE，返回時MIE更新為MPIE。MPP用于保存進中斷之前的特權(quán)模式，如果我們設(shè)置其為MPP=0b11，那么將一直處于機器模式，其mret返回后還是處于機器模式。mepc是機器模式下異常程序指針，其只會在發(fā)生異常是被更新（中斷也是一類異常），進異常時我們可以從另外兩個csr寄存器mcause來看引起異常原因通過mtval查看引起異常時的值。當(dāng)從異常返回時mepc的值被更新給pc。我們正是通過進中斷修改mepc來實現(xiàn)任務(wù)的切換的，后面會詳細(xì)說明這個過程。

實時操作系統(tǒng)大家應(yīng)該不陌生，常見的uCOS，FreeRTOS，RT-Thread，LiteOS-M等等，其基本的思路都是一樣的，需要一個定時器用于系統(tǒng)時間片的實現(xiàn)，一個中斷用于任務(wù)切換。想要其能夠在一個MCU上成功的跑起來，需要弄清除一下幾個事情：

（1）進中斷需要保存哪些內(nèi)容。

從之前的描述中，應(yīng)該知道，對于risc-v內(nèi)核來說其進中斷壓棧的是caller saved的寄存器。從下圖一可以看出，進Systick中斷函數(shù)，先進行寄存器保存，退出中斷時進行寄存器恢復(fù)，如果開啟硬件浮點，同時還會對浮點寄存器進行保存和恢復(fù)。這個過程是編譯器幫我們實現(xiàn)，有一點需要注意的是我們移植的代碼里面進中斷后獲取了中斷的堆棧“csrrw sp，mscratch，sp”，返回時恢復(fù)了線程的堆棧指針“csrrw sp，mscratch，sp”中斷堆棧指針初始值是在任務(wù)開始時存入mscratch寄存器的，如果采用C形式中斷函數(shù)，中斷堆棧的獲取會在壓棧操作之后，中斷壓入的堆棧是當(dāng)前運行任務(wù)的任務(wù)堆棧區(qū)域，如果想要中斷函數(shù)壓棧時壓入的自己的堆棧區(qū)域，可以使用匯編入口，進中斷后先修改sp，然后壓棧，再調(diào)用中斷處理函數(shù)，如圖二所示。

圖1

圖2

（2）任務(wù)棧需要保存哪些內(nèi)容。

前文說過對于一個正常運行的程序，切換任務(wù)前，除了x0恒0，x3 gp指針外，其余的寄存器均需要保存，每個RTOS中都會定義一個上下文保存相關(guān)的結(jié)構(gòu)體，這里我們以華為鴻蒙LiteOS_M為例，看一下這個結(jié)構(gòu)體：

圖3在創(chuàng)建任務(wù)的時候均會為一個任務(wù)分配一個id和堆棧大小并對這個堆棧做初始化：

圖4

圖5任務(wù)創(chuàng)建好了后會關(guān)聯(lián)一個根據(jù)任務(wù)id關(guān)聯(lián)一個任務(wù)控制塊taskCB，總的任務(wù)個數(shù)是在頭文件中配置的（target_config.h）總的任務(wù)塊的初始化也是在LOS_KernelInit被初始化。

圖6從上面可以看出來，task---》taskCB---》sp指針---》memory這樣的路線，而這片memory開始位置用于上下文保存。

這樣的方式在其他RTOS中也可以看到，例如RT-Thread中用于上下文保存的結(jié)構(gòu)體rt_hw_stack_frame，和taskCB類似的結(jié)構(gòu)體rt_thread等。

圖7

圖8

（3）如何開啟任務(wù)調(diào)度。

前面看了每個任務(wù)上下文保存位置，注意到堆棧初始化的時候把任務(wù)的入口地址給了context-》epc。同時LiteOS_M源碼中定義了一個LosTask類型的全局變量g_losTask，其內(nèi)部只有兩個任務(wù)控制塊指針，一個指向當(dāng)前運行的任務(wù)，一個指向新任務(wù)，即要切換至的任務(wù)。

圖9當(dāng)做好一系列初始化后，LiteOS會調(diào)用HalStartSchedule來初始化系統(tǒng)節(jié)拍定時器，并注冊系統(tǒng)定時器的中斷處理函數(shù)，然后開始轉(zhuǎn)向執(zhí)行第一個任務(wù)，如下圖所示：

圖10其中OsSchedStart函數(shù)從任務(wù)列表中獲取第一個任務(wù)，并賦值給g_losTask里面的runTask和newTask。然后調(diào)用HalStartToRun轉(zhuǎn)向執(zhí)行runTask所指示的任務(wù)。HalStartToRun是一段匯編代碼，下面就具體看其如何切換至runTask，具體如下圖的注釋：

圖11這樣mret之后就轉(zhuǎn)向去執(zhí)行第一個任務(wù)，并且不會再有返回，因為每個任務(wù)本身會是個循環(huán)，這里也就能理解其源碼注釋 never return的含義。

圖12其他操作系統(tǒng)中也有類似的操作，例如RT-Thread中有個rt_hw_context_switch_to函數(shù)，其也是匯編代碼實現(xiàn)，它是一個帶參數(shù)的函數(shù)，其傳入的參數(shù)為（&to_thread-》sp），如下圖：

圖13從名字就可以看出，傳遞的參數(shù)為啟動執(zhí)行的第一個線程的控制塊的堆棧指針sp的值，后面賦值mepc，mstatus，其他寄存器等等都是和LiteOS_M一致的。

（4）如何進行任務(wù)切換。

了解了如何切換至第一個任務(wù)，那么如何實現(xiàn)不同任務(wù)之間的切換呢，在這之前我們應(yīng)該都有了解，RTOS是根據(jù)任務(wù)的優(yōu)先級和時間片進行輪轉(zhuǎn)的，每個任務(wù)執(zhí)行一段時間，然后切換至下一個任務(wù)執(zhí)行。每次切換前我們需要把當(dāng)前任務(wù)的運行狀態(tài)進行保存，然后切換至新任務(wù)，對其運行狀態(tài)進行恢復(fù)，如此循環(huán)反復(fù)，實現(xiàn)任務(wù)調(diào)度。時間片實現(xiàn)使用的是內(nèi)核的SysTick定時器，LiteOS_M是在los_timer.c中實現(xiàn)的，這個只需要根據(jù)實際硬件的進行初始化就行。其他操作系統(tǒng)也是類似，像RT-Thread源碼中我們根據(jù)硬件完成board.c。對于任務(wù)切換，我們利用內(nèi)核的軟中斷，只要使能該中斷，并且當(dāng)需要切換任務(wù)時，把中斷控制器的對應(yīng)的pendset位置1，即可觸發(fā)該中斷進行任務(wù)切換。下圖是liteOS_M切換過程：

圖14

圖15

其他操作系統(tǒng)也是大同小異，具體的區(qū)別僅僅是在切換新任務(wù)時，新任務(wù)如何獲取的問題，上圖可以看到LiteOS_M是通過g_losTask來管理，RT-Thread中定義了from_thread，to_thread，顧名思義從一個線程切換至另外一個線程。

弄清楚以上的問題，對于某一個RTOS的基本移植來說應(yīng)該就比較明了。

最后移植好的鴻蒙os，RT-Thread等實時操作系統(tǒng)的代碼均已在MRS上線，可以直接創(chuàng)建，開發(fā)相關(guān)應(yīng)用

原文標(biāo)題：RISC-V MCU開發(fā)實戰(zhàn) （三）：移植鴻蒙OS項目

文章出處：【微信公眾號：電子發(fā)燒友論壇】歡迎添加關(guān)注！文章轉(zhuǎn)載請注明出處。
責(zé)任編輯:pj