Release 0.6.5 real IPC worker
FemLite CI / build-test (push) Has been cancelled

This commit is contained in:
shenw
2026-07-05 21:09:37 +08:00
parent 0440ed5a64
commit a2126f360c
23 changed files with 2007 additions and 442 deletions
+20 -4
View File
@@ -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