1.8 KiB
1.8 KiB
CCLite Worker IPC Adapter
文档状态:0.8.x mock 设计稿
本文记录 SPHLite 侧 worker IPC adapter 的边界。当前实现是 mockable adapter,不打开真实 Windows shared memory 或 named event;真实 IPC 后续实现时应复用这里的句柄、状态和错误路径。
1. 模块边界
IPC adapter 只负责:
- 保存 command block、data block、command event 和 done event 名称。
- 写入
READY和DONE状态。 - 等待 command event。
- signal done event。
- 把 shared memory 或 event 打开失败、wait 超时等问题转换为 worker error code。
IPC adapter 不负责:
- 创建、reset 或销毁 CCLite 持有的 shared memory。
- 创建、reset 或销毁 CCLite 持有的 named event。
- 解析 FEMLite 数据。
- 计算 SPH-FEM 接触或 FSI 载荷。
2. 句柄抽象
当前 sphlite_worker_ipc_t 保存以下名称:
| 字段 | 默认命名 |
|---|---|
ipc_name |
CCLite 传入的基础名 |
command_block |
<ipc_name>.command |
data_prefix |
<ipc_name>.data |
command_event |
<ipc_name>.command_event |
done_event |
<ipc_name>.done_event |
调用方也可以通过 CLI 的 --command-block 和 --data-prefix 覆盖默认名称。
3. 状态流程
worker IPC 流程:
init names
open handles
write READY
loop:
wait command event
execute command
write DONE with ack/state/error
signal done event
sphlite_worker_ipc_reset_event 固定返回 CONFLICT,用于锁定 SPHLite 不 reset CCLite event 的约束。
4. 错误路径
| 场景 | 错误码 |
|---|---|
| shared memory 或 event 尚未打开 | IPC |
| wait 超时 | TIMEOUT |
| event reset 尝试 | CONFLICT |
| Windows 真实 IPC 尚未实现 | UNSUPPORTED |
| 非 Windows 真实 IPC | IPC |
mock 模式用于 CTest,不代表真实 IPC 能力完成。