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

87 lines
2.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# CCLite 0.1.x 接口常量冻结记录
本文记录 0.1.x 已用于测试和 mock worker 闭环的接口常量。0.2.x 起若修改这些常量,必须同步升级 ABI/layout 并补兼容说明。
## 1. Worker 启动参数
正式参数:
```text
--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 已接入 |