Files
SPHLite/docs/cclite_worker_api_mapping.md
T
2026-07-05 17:00:13 +08:00

1.9 KiB

CCLite Worker API Mapping

文档状态:0.8.x mock 设计稿

本文记录 worker 命令到 SPHLite 现有 API 的映射。当前实现为动作映射表,用于保证命令分发表不遗漏关键 ABI;真实执行将在 IPC 数据块和 worker 主循环稳定后接入。

1. 命令映射

Worker 命令 SPHLite 动作
INIT INIT_STATE
READ_INPUT sphlite_read_inp
BUILD_MODEL sphlite_build_model
EXPORT_INTERFACE sphlite_coupling_get_region_count
EXPORT_INTERFACE sphlite_coupling_get_region_info
EXPORT_INTERFACE sphlite_coupling_export_particles
EXPORT_INTERFACE sphlite_coupling_export_facets
IMPORT_LOADS sphlite_coupling_apply_particle_forces
IMPORT_LOADS sphlite_coupling_apply_facet_pressures
IMPORT_LOADS sphlite_coupling_apply_facet_tractions
IMPORT_LOADS sphlite_coupling_apply_facet_resultants
IMPORT_LOADS sphlite_coupling_apply_contact_state
IMPORT_LOADS sphlite_coupling_apply_motion_boundary
ADVANCE sphlite_advance_explicit
WRITE_OUTPUT sphlite_write_output
STOP STOP

2. 错误映射

当前策略:

SPHLite API status 0      -> worker OK
SPHLite API status 非 0   -> worker INTERNAL

真实执行阶段应在返回 INTERNAL 前读取 sphlite_get_last_error,并把 last error 写入 worker log 和 command block error message。

3. 验收边界

本阶段只保证命令到动作的映射完整,并提供 mock 测试。它不保证 shared memory 数据布局、真实载荷导入、真实推进或真实 CCLite 联调已经完成。

v2 预留字段、valid flags、contact state 扩展、拒绝原因和 boundary/ghost 缓存语义记录在 CCLite Coupling Manifest,并由 sph_worker_contract 的 smoke 测试守住命名和清零策略。