快速上手
前置条件
- 一块受支持的评估板:STM32G071RBT6(Cortex-M0+)、STM32F429ZIT6 (Cortex-M4)、STM32H743ZIT6(Cortex-M7)或 CH32V307VCT6 (RV32IMAC)。
- 受支持的工具链:Keil uVision 5(armcc)、IAR EWARM 或 GCC/Clang-LLVM。其他工具链目前既不推荐也不支持。
- RME 和弦微内核(M7M1) ——RVM 构建于其上。
仓库布局
工程生成器(rvgen)按相对路径定位各仓库,请把它们放在同一根目录下 保持平级:
<root>/
├─ M7M02_Ammonite/ RVM 虚拟机监视器本体(Monitor、Platform、Guest/)
├─ M7M01_Eukaron/ RVM 所依赖的 RME 微内核
├─ M5P01_Prokaron/ RMP 实时内核(原生自带 RVM 平台层)
├─ FreeRTOS_V900/ 客机系统目录树——移植源码在这里
├─ uCOSII_V293/
├─ uCOSIII_V308/
├─ RTThread_V411/
├─ DjyOS_V110/
├─ KLite_V521/
├─ RTEMS_V701/ RTEMS 7.0-rc1 BSP/spec/sample 覆层
└─ Zephyr_V370/ Zephyr 3.7.0 LTS west 工作区覆层厂商提供的硬件抽象层软件包请到 M0P0_Library 仓库下载。
生成工程
所有客机都由 M7M02_Ammonite Project/ 目录下的 RVM 工程生成器 rvgen 驱动。.rvp 工程文件选择芯片、平台与客机类型:
<Guest_Type> | 客机 |
|---|---|
RMP | RMP |
FRT | FreeRTOS |
UO2 | uC/OS-II |
UO3 | uC/OS-III |
RTT | RT-Thread |
RTE | RTEMS 7.0-rc1(ARMv7-M + GCC) |
ZPR | Zephyr 3.7.0 LTS(ARMv7-M + GCC) |
DJY | DjyOS(纪念性) |
KLT | KLite(纪念性) |
RTEMS 与 Zephyr 需要先准备官方构建环境(RTEMS 需要 arm-rtems7-gcc 和 官方源码树;Zephyr 需要 west、CMake/Ninja 和一个 Zephyr 3.7.0 LTS west 工作区)。只有在原生构建通过后再叠加 RTEMS_V701 / Zephyr_V370 覆层, 详见 GUEST.md。
有两个入口脚本:
benchmark.sh——生成标准基准测试镜像(即 性能测试表的数据来源)。generate.sh——不带基准选项运行同一生成器;客机由<guest>_main.c中的普通应用启动,该文件被复制进工作区作为main.c(带空闲停车钩子)。两个脚本必须给定相同的源码根目录。
生成器输出构建系统(GCC Makefile / Keil / IAR 工程),包含正确的头文件 搜索顺序,并把所需的移植文件复制进生成的工作区。
Windows 用户
请把二进制转 C 工具 (bincopy.exe)复制到编译器所在目录——Keil uVision 5 对应:
Keil\ARM\ARMCC\bin\bincopy.exeEclipse-GCC 则复制到 GCC 安装目录。
编译与运行
- 用你的工具链打开生成的工程(GCC Makefile 版直接
make)并编译。 - 把镜像烧录到板卡。示例只用串口,且已为你配置好。
- 开始单步调试,或直接运行并观察串口控制台——基准测试会把结果打印在 那里(如
PASS: 0 faults, 9 items)。
手动集成客机
Guest/ 库只包含新增文件——绝不覆盖官方内核源码,直接覆盖合并是 安全的:
- 把客机目录(如
FreeRTOS_V900/)覆盖到同版本官方目录树根部 (合并目录)。 - RVM 移植目录落在官方移植旁边,就像额外的官方移植一样(如
portable/GCC/ARM_A7M_RVM/)。 - 如客机有移植层开关则按需配置(见客机支持)。
不要直接改镜像
M7M02_Ammonite/Guest/ 是由 update-maintainer-only.sh 生成的镜像。 请修改源目录树(如 RTThread_V411/),然后在 Guest/ 目录下重新运行 该脚本。
超级调用
RVM 使用准虚拟化技术来减小运行时间消耗和内存消耗,提供一系列超级调用 (hypercall)来提供敏感的特权级操作:控制台输出、虚拟中断控制、虚拟 中断映射、事件通道、休眠与看门狗管理。
| 超级调用 | 调用号 | 功能描述 |
|---|---|---|
| RVM_HYP_SPURIOUS | 0 | 伪超级调用,忽略(定时器中断先于请求抵达时产生) |
| RVM_HYP_PUTCHAR | 1 | 打印一个字符到控制台 |
| RVM_HYP_REBOOT | 2 | 重启当前虚拟机 |
| RVM_HYP_INT_ENA | 3 | 开启虚拟机中断 |
| RVM_HYP_INT_DIS | 4 | 关闭虚拟机中断 |
| RVM_HYP_VCT_PHYS | 5 | 将虚拟机虚拟中断与物理中断映射登记 |
| RVM_HYP_VCT_EVT | 6 | 将虚拟机虚拟中断与事件通道映射登记 |
| RVM_HYP_VCT_DEL | 7 | 删除一个虚拟中断映射 |
| RVM_HYP_VCT_LCK | 8 | 锁定虚拟机中断映射表 |
| RVM_HYP_VCT_WAIT | 9 | 休眠虚拟机直至中断到来 |
| RVM_HYP_EVT_ADD | 10 | 为虚拟机增加一个事件源的发送能力 |
| RVM_HYP_EVT_DEL | 11 | 删除虚拟机对一个事件源的发送能力 |
| RVM_HYP_EVT_SND | 12 | 向一个事件通道发送事件 |
| RVM_HYP_WDG_CLR | 13 | 启动并喂看门狗 |
说明
- 虚拟屏蔽与物理屏蔽。
CPSID/BASEPRI只屏蔽物理中断,对虚拟中断 送达没有任何作用。客机必须使用RVM_HYP_INT_ENA/RVM_HYP_INT_DIS(或其 C 封装RVM_Virt_Int_Unmask()/RVM_Virt_Int_Mask())控制虚拟 中断的送达。 - 空闲停车。 用户手册(§4.4.3)要求客机空闲线程反复调用
RVM_HYP_VCT_WAIT(超级调用 9):它挂起用户线程并将其移出运行队列, 直到下一个虚拟中断到来——这就是阻止空闲客机空转烧 CPU 的机制。该调用 是透明挂起——在调用点恢复、不改内核状态、也绝不在 RTOS 意义上阻塞。 各客机通过自己的官方空闲钩子接入(vApplicationIdleHook、OS_AppIdleTaskHookPtr、rt_thread_idle_sethook、djy_set_idle_hook、klt_set_idle_hook)。 - 事件通道。 超级调用 5/6/10/11/12 构成虚拟机间通信机制:虚拟中断 映射到事件通道,发送能力按虚拟机授予——通信设计详见 用户手册。
