RarVM Toolchain 技术文档

1. 安装指南

首先，请确保你的环境中已经安装了必要的依赖。以下是安装 RarVM Toolchain 的基本步骤：

• 克隆或下载项目代码到本地。
• 使用 make 命令编译项目。

git clone https://github.com/your-username/RarVM-Toolchain.git
cd RarVM-Toolchain
make

编译完成后，你可以在项目中找到生成的工具链。

2. 项目的使用说明

RarVM Toolchain 包括两个基本工具：链接器和汇编器。以下是使用这些工具的基本步骤：

• 将你的 RarVM 汇编程序（.rs 文件）通过 C 预处理器转换为 .ri 文件。
• 使用汇编器将 .ri 文件汇编为 .ro 文件。
• 使用链接器将 .ro 文件链接为 .rar 文件。

例如，使用以下 Makefile 规则：

%.ri: %.rs
        $(CPP) < $< > $@

%.ro: %.ri
        $(RARAS) -o $@ $<

%.rar: %.ro
        $(RARLD) $< > $@

3. 项目API使用文档

RarVM 的汇编语言支持多种操作数类型：

• 寄存器（例如 r0, r1, ..., r7）
• 内存引用（例如 [#0x12345]）
• 寄存器间接引用（例如 [r0]）
• 基址 + 索引间接引用（例如 [r4+#0x1234]）
• 立即数（例如 #0x12312）
• 符号引用（例如 jmp $next_loop）

以下是示例代码：

_start:
    mov     r3, #0x1000                 ; 输出缓冲区。
    mov     [r3+#0], #0x6c6c6548        ; 'lleH'
    mov     [r3+#4], #0x57202c6f        ; 'W ,o'
    mov     [r3+#8], #0x646c726f        ; 'dlro'
    mov     [r3+#12], #0x00000a21       ; '!\n'
    mov     [VMADDR_NEWBLOCKPOS],  r3   ; 指针
    mov     [VMADDR_NEWBLOCKSIZE], #14  ; 大小
    call    $_success

4. 项目安装方式

请参考上述的安装指南。安装步骤包括从源代码编译工具链。

---

以上就是 RarVM Toolchain 的技术文档。在使用过程中，请确保遵循项目指南，并在遇到问题时参考已知的常见问题解答。