FIX 共享内存使用说明 V2

20260416 更新

FIX 设备配套的客户端开发资源。

共享内存通信 (fixSharedMemory_dll/)

FIX 通过共享内存向外部程序提供任务提交与结果获取接口。纯 C API，无编译器版本限制。

文件清单

快速开始

1. 将 fixSharedMemory_api.h 和 fixSharedMemoryDll.lib 加入项目
2. 运行时将 fixSharedMemoryDll.dll 部署到 exe 同目录
3. 详细 API 说明见 fixSharedMemory_dll_README.md

三种工作流程

外部程序通过共享内存向 FIX 发送数据，FIX 处理完毕后返回一次结果。每次请求有且仅有一次响应。

流程一：仅重建（投影数据，不带教学文件）

适用场景：只需要将投影数据重建为体数据，不需要执行检测。

流程二：重建 + 教学文件（投影数据 + 教学文件）

适用场景：发送投影数据，自动完成重建和检测的完整流程。

流程三：体数据 + 教学文件（已重建的体数据 + 教学文件）

适用场景：体数据已在外部完成重建，只需要 FIX 执行检测。

返回格式

所有流程统一返回 JSON 格式：

{
  "_metadata": {
    "application": "FIX Inspection",
    "version": "1.0",
    "createdAt": "2026-04-10T10:12:49",
    "dataName": "PCB_Projection",
    "teachingFile": "PCB1",
    "elapsedMs": 2970,
    "status": "OK"
  },
  "results": [ ... ]
}

字段说明

三种流程的返回差异

返回示例

仅重建（无检测）：

{
  "_metadata": { "status": "OK", "teachingFile": "", "elapsedMs": 1850, ... },
  "results": []
}

重建 + 检测：

{
  "_metadata": { "status": "OK", "teachingFile": "PCB1", "elapsedMs": 2970, ... },
  "results": [
    { "roiId": 1, "roiName": "C1", "stubLength_um": 150.3, "judgment": "PASS" },
    { "roiId": 2, "roiName": "C1", "stubLength_um": 148.7, "judgment": "PASS" }
  ]
}

注意：results 中的具体字段取决于检测项目类型，不同项目的字段可能不同。

configJson 控制参数

客户端通过 --recon-config pcb.json 传入 configJson，其中 _metadata 包含行为控制参数，优先于共享内存数据包字段和 FIX 界面设置。

{
  "_metadata": {
    "teachingFile": "PCB1",
    "loadToViewer": false
  },
  "geometry": { ... },
  ...
}

teachingFile — 教学文件指定

优先级：共享内存数据包的 teachingFile 字段优先；如果为空，则从 configJson 补充。推荐统一在 configJson 中设置。

loadToViewer — 显示渲染控制

客户端推荐用法

# 重建 + 检测，不显示渲染（最快）
test_fixSharedMemoryDll.exe -d "数据目录" -n PCB_Projection -p \
  --recon-config pcb.json
# pcb.json 中: "teachingFile": "PCB1", "loadToViewer": false

# 仅重建，无检测
# pcb.json 中: 不设 teachingFile 或设为 ""

通信原则

• 一收一回：每次请求，FIX 处理完毕后统一返回一次结果
• 双通道：发送通道（客户端 -> FIX）和响应通道（FIX -> 客户端）独立工作
• 超时机制：客户端可设置等待超时时间，超时后自动断开
• 异步自动过期：异步请求如果 5 分钟内未收到响应，DLL 自动标记为超时并触发 completion callback
• 线程安全：所有 DLL API（包括 fsChannelGetLastError）可在任意线程安全调用；回调函数在 DLL 内部线程触发，注意同步

本文件随 FIX 安装包分发。后续 SDK 扩展将在此追加说明。