This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# 05 接口控制文档
|
||||
|
||||
文档状态:0.6.4 版整理稿
|
||||
文档状态:0.6.5 版整理稿
|
||||
|
||||
## 1. Fortran API 总则
|
||||
|
||||
@@ -276,9 +276,9 @@ seq,ack_seq,command_id,step_id,substep_id,iteration_id,state,error_code
|
||||
- `ADVANCE` 使用单步显式推进。
|
||||
- `WRITE_OUTPUT` 调用现有 CSV 与 VTU/PVD 输出路径。
|
||||
|
||||
## 9. CCLite Windows IPC Adapter
|
||||
## 9. CCLite Windows IPC Worker
|
||||
|
||||
阶段 C 提供 Windows IPC adapter 的 C 层边界,供后续真实 CCLite worker 接入。当前 adapter 已有 shared memory、named event、command block 读写和 smoke,不等同于主程序已经完成跨进程 worker 联调。
|
||||
阶段 C 提供 Windows IPC adapter 的 C 层边界。0.6.5 起主程序 worker 已接入真实 Windows IPC 后端,可由外部驱动创建 shared memory、named event 和 data block 后启动 `femlite --cclite-worker --worker-backend ipc`,完成 READY、INIT 到 STOP、空载荷推进和超时/异常退出闭环。
|
||||
|
||||
C 头文件:
|
||||
|
||||
@@ -299,6 +299,7 @@ typedef struct femlite_cclite_command_block {
|
||||
int32_t iteration_id;
|
||||
int32_t worker_state;
|
||||
int32_t error_code;
|
||||
char error_message[128];
|
||||
} femlite_cclite_command_block;
|
||||
```
|
||||
|
||||
@@ -316,9 +317,24 @@ adapter 约定:
|
||||
- FemLite 可以 wait `COMMAND_EVENT`、读取 command block、写回 `ack_seq`/`worker_state`/`error_code` 并 signal `DONE_EVENT`。
|
||||
- FemLite 不 reset event;reset 责任属于 CCLite 侧。
|
||||
- timeout 使用稳定错误码 `FEMLITE_CCL_IPC_ERR_TIMEOUT`。
|
||||
- 当前 smoke 覆盖 open、wait/signal、不 reset event、INIT/STOP、错误路径和 100 step 空耦合。
|
||||
- 当前 smoke 覆盖 open、wait/signal、不 reset event、INIT/STOP、错误路径、真实进程 1 step/100 step 空耦合和 timeout。
|
||||
- `femlite_cclite_transport` 提供 mock 和 Windows IPC 两个 backend 的统一 `receive/complete` facade。
|
||||
|
||||
data block 命名规则:
|
||||
|
||||
```text
|
||||
<data-prefix>_FEM_TO_CCL_FACET
|
||||
<data-prefix>_CCL_TO_FEM_LOAD
|
||||
```
|
||||
|
||||
data block 采用 `AOR_V1` 布局:
|
||||
|
||||
- header 字段包含 `magic`、`version`、`layout`、`record_type`、`record_capacity`、`record_count`、`record_stride`、`status_code`、`error_code` 和短错误消息。
|
||||
- `FEM_TO_CCL_FACET` 记录包含 facet id、surface id、element/face id、节点列表、节点位置、节点速度、法向、面积、材料/截面 id、`body_id=0` 占位、valid flags、壳厚度和面密度。
|
||||
- `CCL_TO_FEM_LOAD` 记录包含 record id、step id、node id、source id、load mode、distribution mode、valid flags、节点力和预留力矩字段。
|
||||
- 容量不足、版本不匹配或 record stride 不匹配会返回错误,不静默截断。
|
||||
- 当前中立 data block 已支持 facet 导出和节点力导入;facet pressure、moment 和 kinematic boundary 仍是后续能力。
|
||||
|
||||
## 10. 输出接口
|
||||
|
||||
```fortran
|
||||
|
||||
Reference in New Issue
Block a user