|
|
@@ -1,50 +1,52 @@
|
|
|
# Fantasy Virtual Machine
|
|
|
|
|
|
-A 64-bit stack-based virtual machine and its assembler, created for fun.
|
|
|
+玩具64位栈式虚拟机和汇编器
|
|
|
|
|
|
-## Build
|
|
|
+## 构建
|
|
|
|
|
|
-FVM includes two parts: the virtual machine and the assembler.
|
|
|
+FVM由两部分组成：虚拟机和汇编器
|
|
|
|
|
|
-The build the assembler, you need to intall CHICKEN Scheme first.
|
|
|
+构建汇编器需要Chicken Scheme编译器。大部分主流Linux发行版都提供该编译器。
|
|
|
|
|
|
-For example, on Arch Linux:
|
|
|
+例如，在Arch Linux上：
|
|
|
|
|
|
sudo pacman -S chicken
|
|
|
|
|
|
-Then install CHICKEN Scheme dependencies:
|
|
|
+
|
|
|
+然后，安装Chicken Scheme依赖包：
|
|
|
|
|
|
sudo chicken-install matchable srfi-69 srfi-4
|
|
|
|
|
|
-Then run make, which will build both components:
|
|
|
+然后运行`make`。`make`会自动构建两个组件。
|
|
|
|
|
|
make
|
|
|
|
|
|
-If successful, you will see two executables, the virtual machine `fvm` and the assembler `fvm-as`.
|
|
|
+构建成功后，会产生两个可执行文件：虚拟机`fvm`和汇编器`fvm-as`。
|
|
|
+
|
|
|
+## 运行
|
|
|
|
|
|
-## Run
|
|
|
+写完汇编代码后（`examples/`目录中有示例），首先运行汇编器：
|
|
|
|
|
|
-After writing the assembly code (examples can be found in the `examples/` directory), first run the assembler:
|
|
|
|
|
|
./fvm-as input.asm bytecode.bin
|
|
|
|
|
|
-This will generate the bytecode file `output.bin`. Then run the virtual machine:
|
|
|
+汇编器会生成字节码文件`bytecode.bin`。然后运行虚拟机：
|
|
|
|
|
|
./fvm bytecode.bin
|
|
|
|
|
|
-## Registers
|
|
|
+## 寄存器
|
|
|
|
|
|
-FVM contains 4 registers:
|
|
|
+FVM包含4个寄存器：
|
|
|
|
|
|
-- SP: stack pointer
|
|
|
-- BP：base pointer
|
|
|
-- PC：program counter
|
|
|
-- RV: returned value
|
|
|
+- SP：栈顶指针
|
|
|
+- BP：栈基指针
|
|
|
+- PC：程序计数器
|
|
|
+- RV：返回值
|
|
|
|
|
|
-There are no general-purpose registers; all operations happen on the stack.
|
|
|
+FVM不包含通用寄存器，所有运算都在栈上进行。
|
|
|
|
|
|
-## Opcodes
|
|
|
+## 指令
|
|
|
|
|
|
-All opcodes are single-byte, except for immediate value instructions.
|
|
|
+大部分指令都是单字节的，除了立即数指令。
|
|
|
|
|
|
-See `src/fvm.h` for a full list of opcodes.
|
|
|
+源代码文件`src/fvm.h`中包含了完整指令列表。
|
