Admin
447a8d0119
- Project.h 自带 IoBinding；Stb.h/cpp：compiler 侧 .stb 规范（常量/ConstEntry/FNV/StbView/读写/sidecar） - Codec.h/cpp：指令字 pack/字段/配置驱动 disasm（format 表驱动） - Codegen：opcode 全查 MachineConfig（E_* 发射器）、常量 tag 查配置类型、初值按基元宽度写、 映像拼装用 Stb 常量；codegen_project 增加 cfg 参数 - main.cpp：--machine <path>（编译/反汇编必填），--disasm 用 StbView+Codec - CMake：compiler 不再链接 isa（仅 toml++ 私有）；测试补链 isa（自身断言用） - 验证：20 用例字节不变（hash 0xc3fe4ae74ad45900 相同）、ctest 12/12、缺 --machine 报错退出
StScan
子集 ST + 扫描周期虚拟机。IEC 风格的子集 ST：用 project.toml 组织多个 .st，编译成单一映像，由寄存器虚拟机按扫描周期执行。
方案见 Doc/初步计划.md，模块文档见 Doc/索引.md。
多个 .st
↑ project.toml 列出
↓
STCompiler（compiler 库：词法 / 语法 → 符号表 → 类型检查 → 寄存器码 → 链接）
↓
<name>.stb 映像 + <name>.runtime.toml sidecar
↓
BytecodeExecutor（vm 库按扫描周期执行；喂 I、收 Q、给 Δt、回放）
目录
.
├── CMakeLists.txt # 顶层工程：加入各目标，并启用测试
├── cmake/ # CMake 辅助（警告、C++ 标准等），不是业务模块
├── isa/ # 共享契约：指令、映像、定宽类型
├── compiler/ # ST / toml 编译器（库）+ STCompiler 可执行入口
├── vm/ # 寄存器虚拟机（库）
├── executor/ # BytecodeExecutor：加载 .stb + sidecar 并执行
├── examples/ # 样例工程（给人看、跑通最小闭环）
│ └── line1/ # MAIN + Motor FB + I/O
│ ├── project.toml
│ ├── globals.st
│ ├── motor.st
│ └── main.st
├── tests/ # 自动化用例（语法、链接、指令、回放）
├── third_party/ # 第三方（如 toml 解析），compiler 私有链接
└── Doc/ # 设计文档
样例和测试是数据，不做成 CMake 库。每个用例是一份 toml + 若干 .st，按工程子目录存放。
模块与 CMake 目标
三个静态库与两个可执行，与目录一一对应。compiler 与 vm 不互相链接，合同放在 isa。依赖方向：STCompiler → compiler → isa、BytecodeExecutor → vm → isa。
| 目录 | 目标 | 类型 | 依赖 | 职责 |
|---|---|---|---|---|
isa/ |
isa |
STATIC |
无 | 约 20 条指令编码、映像头、工程哈希、BOOL / INT / TIME 宽度 |
compiler/ |
compiler |
STATIC |
isa |
读 toml、收齐 .st、解析、链接、定址、类型检查、编寄存器码、写映像 |
vm/ |
vm |
STATIC |
isa |
一台 VM、一个入口、一份映像；扫描周期、寄存器、FB、有界 CALL / RET |
compiler/ |
STCompiler |
EXECUTABLE |
compiler、isa |
STCompiler <project.toml> -o <name>.stb：编译并写映像 + sidecar；--disasm 可反汇编 |
executor/ |
BytecodeExecutor |
EXECUTABLE |
vm、isa |
BytecodeExecutor <name>.stb：加载映像 + sidecar，采样 I、执行 PROGRAM MAIN、写回 Q、用 Δt 推进定时器 / 计数器、回放 |
词法、语法、符号表、检查、codegen、链接都留在 compiler 一个库里，不再拆 CMake 子库。
isa
编译器写映像、虚拟机读映像，两边共用同一套编码。放这里避免循环依赖。
compiler
toml 不声明变量，只列出源文件、指定唯一 GVL、可选地把已有全局接到硬件。VAR_GLOBAL 第一版只允许出现在 gvl.file（如 globals.st）。
vm
每个扫描周期：采样 I → 从 PROGRAM MAIN 的 pc=0 执行到 RET → 写回 Q → 用本周期 Δt 推进 TON / TOF / CTU。无 GC、无堆、无线程；变量编译期分配。
executor（BytecodeExecutor）
第一版两个可执行：STCompiler 编译出 <name>.stb（映像）+ <name>.runtime.toml（sidecar：I/O 绑定）；BytecodeExecutor 加载后按扫描周期跑。不再有"一条命令编译 + 跑"。dt_ms / cycle_limit 从映像头取。
examples/ 与 tests/
| 目录 | 用途 |
|---|---|
examples/line1/ |
计划中的最小样例：全局、MotorStarter FB、PROGRAM MAIN |
tests/ |
冻关键字、指令、符号表、链接错误（重复 VAR_GLOBAL、io.var 未声明等） |
tests/ 通过 add_test 调 STCompiler / BytecodeExecutor，或直接链接 compiler + vm。样例工程数据按「一份 toml + 若干 .st」分子目录存放，不做成 library。