Files
CCLite/docs/0.1.x_interface_constants.md
2026-07-05 17:21:51 +08:00

2.0 KiB
Raw Permalink Blame History

CCLite 0.1.x 接口常量冻结记录

本文记录 0.1.x 已用于测试和 mock worker 闭环的接口常量。0.2.x 起若修改这些常量,必须同步升级 ABI/layout 并补兼容说明。

1. Worker 启动参数

正式参数:

--cclite-worker --solver-id <SPH|FEM> --case <solver.inp> --ipc-name <prefix> --timeout-ms <milliseconds>

兼容别名:

  1. --ipc-prefix:0.1.5 早期 mock worker 参数,0.1.7 起仅作为兼容;
  2. --solver-input:0.1.5 早期 mock worker 参数,0.1.7 起仅作为兼容。

2. Solver Id

id 名称
1 SPH
2 FEM
3 CCL

3. Command Id

id 名称
1 INIT
2 READ_INPUT
3 BUILD_MODEL
4 EXPORT_INTERFACE
5 IMPORT_LOADS
6 ADVANCE
7 WRITE_OUTPUT
99 STOP

4. Worker State

id 名称
1 STARTING
2 READY
3 BUSY
4 DONE
5 ERROR
6 STOPPED

5. Data Layout

id 名称 0.1.x 状态
1 AOR_V1 已实现
2 SOA_V2 0.8.x 预留,0.1.x 拒绝

6. Block Role

role 名称 0.1.x 状态
101 SPH_TO_CCL_PARTICLE 已实现,mock 可写空 block
102 SPH_TO_CCL_FACET 预留
201 FEM_TO_CCL_FACET 已实现,mock 可写空 block
301 CCL_TO_SPH_FORCE 已定义,0.1.x 写空 block
302 CCL_TO_FEM_LOAD 已定义,0.1.x 写空 block
401 CCL_DIAGNOSTIC 已定义
901 CCL_COMMAND_SPH 已定义
902 CCL_COMMAND_FEM 已定义

7. Buffer State

id 名称
0 EMPTY
1 WRITING
2 READY
3 READING
4 CONSUMED
5 ERROR

8. 0.1.x 验收算例

算例 状态
V010_EMPTY_COUPLING 通过,mock SPH/FEM worker 完成 100 step 空耦合
真实 worker gap audit 通过,输出受控缺口报告,不声明真实 worker 已接入