只需3个函数就够了:rv核心API速查指南(rv_init / rv_step / rv_irq 快速上手清单)
只需3个函数就够了rv核心API速查指南rv_init / rv_step / rv_irq 快速上手清单【免费下载链接】rv32-bit RISC-V CPU in ~800 lines of C89项目地址: https://gitcode.com/gh_mirrors/rv/rvrv是一个用约 800 行 C89 代码实现的 32 位 RISC-V CPU 模拟器RV32IMAC完整支持 M 模式与 S 模式甚至可以直接引导启动 RISC-V 32 位 Linux。它的 API 设计极简rv_init、rv_step、rv_irq三个函数再加上你自己提供的一个内存回调就能在一台软件 CPU上跑起真实程序。本文是面向新手的 rv 核心 API 速查清单。rv 是什么先花 30 秒了解在写代码之前你需要知道 rv 的定位特性说明指令集RV32IMAC_Zicsr含原子、压缩、乘除法扩展特权级支持 M-mode 与 S-mode含完整 CSR 和 TLB代码量约 800 行 C89无内存分配无 64 位整数API2 个必调函数 1 个中断函数 1 个你写的内存回调战绩通过 riscv-tests 全部支持项可启动 RISC-V32 Linux核心文件只有两个接口定义在 rv.h全部实现在 rv.c。rv_init 初始化一行完成 CPU 复位void rv_init(rv *cpu, void *user, rv_bus_cb bus_cb);这是使用 rv 的第一步它做了三件事清零整个 CPU 状态——32 个通用寄存器r[32]、程序计数器、所有 CSR设置复位向量——PC 指向0x80000000RISC-V 惯例的 RAM 基址写入身份特征——设置misa寄存器声明支持 I/M/A/C 扩展和 U/S 模式初始特权级为 M-mode。两个参数怎么传user一个不透明指针会在每次内存访问时原样传回你的回调函数通常传内存数组的首地址bus_cb你自己实现的总线回调函数下文详解。 小技巧对同一个cpu再次调用rv_init就是一次完整的 CPU 复位调试死循环或挂死状态时非常有用。rv_step 单步执行模拟一颗软 CPU的心脏rv_u32 rv_step(rv *cpu);调用一次 CPU 执行一条指令。它内部完成取指含 C 扩展半字取指、译码、执行、访存全流程并自动累加cycle计数器处理页表翻译satp/TLB若mip有挂起中断按从高到低优先级自动响应见 rv.c 中的rv_service。返回值速查表返回值含义RV_TRAP_NONE正常执行完毕继续下一步RV_TRAP_WFI指令是wfi等待中断CPU 在此打盹RV_E*发生异常编码即 rv.h 中定义的异常号常用异常号一览完整列表见 rv.h宏编号场景RV_EBP3执行到ebreak断点RV_EMECALL11M-mode 执行ecall系统调用RV_ESECALL9S-mode 执行ecallRV_EILL2非法指令最常见的写法就是跑到 ecall 为止while (rv_step(cpu) ! RV_EMECALL) { }rv_irq 触发中断给 CPU 按响铃void rv_irq(rv *cpu, rv_cause cause);RISC-V 的中断不是立即打断执行的——rv_irq只是置位mip寄存器机器中断挂起真正响应发生在下一条rv_step中且需要对应mie使能位打开才会陷入。三种中断源宏值名称典型来源RV_CSI8Supervisor SoftwareSBI / OS 软件中断RV_CTI128Supervisor TimerCLINT 定时器到点RV_CEI512Supervisor ExternalPLIC 外部设备UART 等中断优先级由rv_service按编号从大到小扫描Timer External Software并根据mideleg决定陷入 S-mode 还是 M-mode。唯一的第四函数内存回调 rv_bus_cbrv 自己不管理内存所有读写都交给你的回调rv_res bus_cb(void *user, rv_u32 addr, rv_u8 *data, rv_u32 is_store, rv_u32 width);读从addr拷贝width字节到data写反向拷贝地址越界返回RV_BADrv 会将其转化为相应的 load/store fault 异常。完整可运行的最小示例在 tools/example/example.c一块 64KB 内存 2 条机器码add a7, a7, 42后接ecall约 30 行就把 CPU 跑起来了。编译它只需gcc -o example example.c rv.c。三个函数串起来完整执行循环rv cpu; rv_init(cpu, mem, bus_cb); /* 1. 复位 */ memcpy(mem, program, size); /* 加载程序到 0x80000000 */ for (;;) { rv_u32 res rv_step(cpu); /* 2. 执行一条指令 */ if (res RV_EMECALL) break; /* 3. 捕获系统调用 */ if (res RV_TRAP_WFI) /* 4. CPU 休眠时喂中断 */ rv_irq(cpu, RV_CTI); }这套init → step 循环 → irq 喂中断的骨架正是 tools/linux/mach.c 引导 Linux 的全部原理——配合 CLINT、PLIC、UART 三个小设备驱动同目录就能跑起真实的 RISC-V32 Linux文档见 tools/linux/README.md。新手上手清单✅ 定义一块内存数组 一个越界检查版bus_cb✅rv_init传入内存首地址✅ 把机器码 / 二进制镜像加载到0x80000000✅while循环里调用rv_step用返回值判断异常✅ 需要中断时wfi、定时器、UART调用rv_irq✅ 调试卡死重调rv_init复位或直接打印cpu.pc/cpu.csr.mepc总结rv 的 API 哲学就是CPU 状态全在一个rv结构体里你能做的只有初始化、单步、给中断。三个函数加一个回调约 800 行代码是你理解 RISC-V 指令执行、CSR、中断与页表机制的最佳入口。【免费下载链接】rv32-bit RISC-V CPU in ~800 lines of C89项目地址: https://gitcode.com/gh_mirrors/rv/rv创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

比JDK更快更简洁:uuid-creator的GUID替代API深度体验

比JDK更快更简洁:uuid-creator的GUID替代API深度体验

比JDK更快更简洁:uuid-creator的GUID替代API深度体验 【免费下载链接】uuid-creator UUID Creator is a Java library for generating Universally Unique Identifiers. It generates all standard identifiers from UUIDv1 to UUIDv7. It also provides an alterna…

2026/11/21 8:32:53 阅读更多 →
132个NPU算子接口速查:ops-multimodal-fusion API清单与torch.ops调用详解

132个NPU算子接口速查:ops-multimodal-fusion API清单与torch.ops调用详解

132个NPU算子接口速查:ops-multimodal-fusion API清单与torch.ops调用详解 【免费下载链接】ops-multimodal-fusion 基于 AscendC 的 PyTorch 自定义多模态算子库 项目地址: https://gitcode.com/cann/ops-multimodal-fusion ops-multimodal-fusion 是基于 A…

2026/11/3 20:34:45 阅读更多 →
沈阳有没有专门矫正孩子体态的培训班

沈阳有没有专门矫正孩子体态的培训班

在沈阳,给孩子找体态矫正班,家长最怕的就是花了钱、费了时间,结果机构不专业,甚至把孩子的身体练坏。作为一个在武道培训领域深耕了15年的从业者,我想告诉你一个行业内幕:真正能高效矫正体态的地方&#xf…

2026/10/25 1:00:05 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/20 23:27:28 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/20 23:27:28 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/20 23:27:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/20 21:55:32 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/20 23:27:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/20 22:59:12 阅读更多 →

日新闻

周新闻

月新闻