文档同步:machine.toml 配置驱动架构收尾。
- README.md:依赖方向(STCompiler→compiler 不链 isa)、模块表、isa 归执行器侧、 数据流图(machine.toml + 型号/SHA) - isa/README.md:重写——只管指令定义(Types/Op/Instr/Encode),删 Image 部分 - 指令与映像.md:依赖图与 CMake(compiler 不链 isa) - 编译管线.md:管线首步加载 machine.toml、产物含型号/SHA - 初步计划.md:12.10/12.13 修订(--machine、依赖方向) - 扫描周期.md / 指令执行.md:12.9 步骤标注已落地、vm 读校验说明 - compiler/vm/executor README:依赖与边界同步
This commit is contained in:
+10
-9
@@ -15,7 +15,8 @@ vm 模块:寄存器虚拟机。CMake 目标:`vm`(`STATIC`),只依赖 [
|
||||
|
||||
## 边界
|
||||
|
||||
- 只认 `isa` 映像;类型与溢出按 [`指令与映像.md`](../isa/指令与映像.md)(`INT` 饱和)
|
||||
- 只认 `.stb` 映像(`vm` 自带读实现);读取时**型号标识匹配 + SHA-256 校验**,不符/篡改 → 拒绝
|
||||
- 类型与溢出按 [`指令与映像.md`](../isa/指令与映像.md)(`INT` 饱和);指令定义归 `isa`
|
||||
- 局部 / `VAR` = 固定寄存器;`nregs` 在函数头
|
||||
- `CALL` 目标是立即数 `fn_id`,有界调用栈
|
||||
- 无 GC、无堆、无线程;每周期受 `cycle_limit` 限制
|
||||
@@ -63,7 +64,7 @@ VM 需要无歧义地访问数据区,当前变宽布局(BOOL 1B / INT 2B / T
|
||||
- `Codegen.cpp` 简化:`width_of`/`align_up` 删除、`layout_data`/`layout_fb_instances` 按槽号布局、指令 slot = 符号表槽号
|
||||
- `codegen_test` 断言更新(slot 从字节偏移变槽号、数据区字节数变化)
|
||||
|
||||
### 步骤 1:`Machine.h`(新建 `vm/include/vm/Machine.h`)
|
||||
### 步骤 1:`Machine.h`(已落地 `vm/include/vm/Machine.h`)
|
||||
|
||||
```cpp
|
||||
namespace vm {
|
||||
@@ -83,32 +84,32 @@ namespace vm {
|
||||
```
|
||||
|
||||
- `Fault` 枚举 + 帧结构 `{ fn_id, regs[nregs], ret_pc, ret_fn_id }`;调用栈深度上限 64
|
||||
- 只依赖 `isa`(`ImageView` + 类型/饱和函数)
|
||||
- 只依赖 `isa`(指令定义)+ 自带 `vm::Image`(.stb 读)
|
||||
|
||||
### 步骤 2:`Machine.cpp` 译码 switch
|
||||
### 步骤 2:`Machine.cpp` 译码 switch(已落地)
|
||||
|
||||
- 取指:函数表 → `code_offset`(字节)→ 读 u32 → 拆 `op/rd/a/b`
|
||||
- 标量:`MOVE` / `LOADK`(常量表 tag 定值表示)/ `NOT` / `AND` / `OR`(布尔)/ `ADD/SUB/MUL/DIV`(`sat_*`)/ `CMP_xx`(全宽比较)
|
||||
- 跳转:`JMP` / `JT` / `JF`(`pc += off`,相对下一条语义)
|
||||
- 数据区:`LOAD_I/LOAD_M/LOAD_GLOBAL`、`STORE_Q/STORE_M/STORE_GLOBAL`(同一实现,slot × 8)
|
||||
|
||||
### 步骤 3:CALL / RET 帧栈 + 故障
|
||||
### 步骤 3:CALL / RET 帧栈 + 故障(已落地)
|
||||
|
||||
- `CALL fn_id`:压新帧(复制 r0..r7)→ pc=0;`RET`:复制 r0..r7 回调用方 → 弹栈(MAIN 的 RET = 周期结束)
|
||||
- `cycle_limit` 超限(用例 6)、栈深 > 64、`BadOp` / `BadSlot` / `BadConst` → 周期中止返回故障
|
||||
|
||||
### 步骤 4:定时器与边沿(8 个 CAL_*)
|
||||
### 步骤 4:定时器与边沿(已落地)
|
||||
|
||||
- 执行时用映像 `dt_ms` 推进(每周期一次调用 = 推进一次),不读系统时钟
|
||||
- TON:in 真 → et += dt(到 pt 停)、q = et ≥ pt;in 假 → et = 0
|
||||
- TOF:in 真 → q=1、et=0;掉电 → et += dt、et ≥ pt → q=0
|
||||
- CTU:cu 上升沿(**上次 cu 存 VM 侧 vector**,按实例基槽索引)→ cv+1;r → 复位;q = cv ≥ pv
|
||||
|
||||
### 步骤 5:可观察性基础
|
||||
### 步骤 5:可观察性基础(已落地)
|
||||
|
||||
- `step()` / `pc` / `fn_id` / `cycle_count` / `call_depth` / `reg` 落基础实现;`snapshot()` 留 12.11 补全
|
||||
|
||||
### 步骤 6:`vm_test`(`tests/src/vm_test.cpp` + CMake,链 `vm` 库)
|
||||
### 步骤 6:`vm_test`(已落地)
|
||||
|
||||
- 手工拼小映像(`isa` 编码函数):赋值、跳转、CALL/RET 帧复制、cycle_limit
|
||||
- 编译器产物全链路:用例 01/02/04/05/07/09/13/15/17/18/20 跑周期断言寄存器与数据区
|
||||
@@ -116,6 +117,6 @@ namespace vm {
|
||||
- TON:dt=10、pt=30 → 第 3 周期 q=1;CTU:上升沿计数
|
||||
- **确定性**:同一 I 序列跑两遍,数据区完全一致
|
||||
|
||||
### 步骤 7:验证 + 提交
|
||||
### 步骤 7:验证 + 提交(已落地,ctest 14/14)
|
||||
|
||||
- `cmake --build` + `ctest`(新增 `vm_cycles` 后 10/10 全绿);20 用例扫描:14 正例执行通过
|
||||
|
||||
Reference in New Issue
Block a user