LUX TCP 通讯协议
外部产线控制程序通过 ARVRPro 的 LuxSocketDispatcher 发送文本命令并接收原 LUX 格式响应。现场安装 ProjectARVRPro,项目版本及宿主要求读取其 .csproj 与 manifest。旧独立 ProjectLUX 的源码、专属测试和协议说明通过仓库 Projects/ARCHIVED.md 的归档标签查阅,交付前用它核对差异;后续迭代在 Pro。
部署与配置
- 在“通信 → 服务设置”启用 Socket Server,解析模式选择 Text。默认监听
0.0.0.0:6666,UTF-8;服务默认关闭。Pro JSON 客户端使用 Json 模式,两种模式按现场用途选择。 - 在“流程处理配置 → 其他配置”设置 LUX 协议设备号(默认
H03);使用 VID 时按单次 VID 测量选择相机和方式。LUX 设备号只组成回包前缀。 - 普通流程在活动组的 SocketCode 列填写命令末两位,绑定实际 Flow 模板与 Pro 实例 Recipe。旧 LUX 配置不自动迁移,现场需重新配置;流程和配置存储见 Pro 流程组。
- 准备相机、光谱仪、Flow 服务和输出目录。默认在 Pro 的 CSV 输出目录生成
C_<SN>.csv、B_<SN>.csv、D_<SN>.csv。需要旧 LUX 格式时,在结果保存中开启 保存客户报表,选择LUX_Current_CSV/LUX_Legacy_CSV;此时 C_ 文件使用报表目录,B_/D_ 保持原路径,配置与口径见 LUX 客户 CSV。
共享文本分派器只调用首个发现的 handler,不按命令遍历项目。部署时核对实际接收者,避免同时加载其它文本项目;默认缓冲和协议模式见通用 Socket 服务。协议不提供 TLS 或应用层身份认证,需在受控产线网络中使用。
请求与消息边界
T00XX,<SN>;客户端使用大写 T、两位命令编号和非空 SN。SN 不含逗号、分号、换行或 Windows 文件名非法字符;它还用于导出文件名。服务端只检查 T00 前缀、取命令末两字符,并按第一个逗号分开 SN;宽松解析不构成额外命令保证。
服务端把一次 TCP Read 当成完整请求,不按分号拆包或缓存半包。保持一个长连接,串行完成一条命令后再发送下一条;不要主动拆分或粘连请求。一次 Write 不保证对应一次完整 Read,仍需在真实网络条件下核验分包与断线。
客户端也需缓存半包。VID/光通量的数值位于分号之后,末尾没有结束符;流程失败会在基础响应后追加文本。看到第一个分号不能证明完整响应已到达。可变长数值没有可靠的长度/终止标记,静默等待只是接收策略,截断或缺失值不能当成有效测量。
命令与响应
| 命令 | 执行与响应 |
|---|---|
T0000,SN001; | 立即握手:H0300,SN001,00;。空闲时设置当前 SN,忙碌时不修改正在运行的 SN;不清空已有累计结果,窗口未创建时可直接回复 |
T0001,SN001; | 用指定相机测量 VID,再应用 K/B,输出 B_ CSV;如 H0301,SN001,00;123.45 |
T0031,SN001; | 调用光谱仪 GetData,取得光谱结果时输出 D_ CSV;如 H0331,SN001,00;125.42 |
T0002,SN001; | 按活动组 SocketCode=02 运行流程;回包内容由所选处理类型决定 |
T00XX,SN001; | 运行活动组首个 SocketCode=XX 匹配项绑定的模板,完成后输出 C_ CSV;如 H0321,SN001,00; |
00、01、31 有固定用途,不分配给普通流程;其余命令通过步骤的 SocketCode 路由,光学中心回包不限定命令编号。普通命令不检查步骤 IsEnabled,不会自动发送下一项 SwitchPG 或最终 JSON。模板按该步骤的实际绑定查找,不使用旧 LUX 的名称子串匹配。
普通回包为 <MachineNO><XX>,<SN>,00;。固定 00 不代表 Recipe PASS 或整机合格;步骤或模板缺失时也可能只返回此前缀。客户端结合结果界面、SQLite 和 CSV 判定业务结果,不能把回包当成完成全部测试的证据。
需要三轴回包的步骤选择 ARVR → 光学与几何 → 光学中心(回包),切换后核对该实例的 Recipe 限值和 K/B。选择类型即启用回包,不需要将设备号改成 H03AR,步骤可使用任意未保留的 SocketCode。已有配置不会自动换类型。OpticCenterLuxProcess 继承普通 OpticCenterProcess,复用解析、修正、判定和 CSV,通过可选接口 ILuxFlowResponseProvider 生成三轴回包及成功、缺值、失败时的前缀。普通及动态光学中心不实现此接口;窗口只把本次执行实例和结果交给通用调度器,不读取累计光学中心结果。
专用响应从本次已完成流程的结果快照读取 Rotation、TiltX、TiltY,与步骤索引无关。设备号与命令编号只构成前缀,例如设备号 H03AR、SocketCode 02 时:
H03AR02,SN001,1,2,3,00;设备号保持默认 H03、SocketCode 配为 21 时,同样返回 H0321,SN001,1,2,3,00;。其他处理类型仍使用普通响应,不因设备号或命令编号隐式添加三轴值。
已选择“光学中心(回包)”但结果归属不匹配、快照无效或三轴缺项/非有限数值时,只返回设备号、命令编号和 SN 前缀,例如 H03AR02,SN001,不能当作有效三轴结果;不补零、不沿用其他步骤或上次测量值。接口生成失败及无效结果会记录原因。有效零值和 Recipe 超限的测量仍按原格式回传。FindCross 继续使用普通光学中心的 optCenter / ImageCenter 识别规则,图像中心不替代光学中心。
T0031 光通量请求使用本地后端且光谱仪关闭时,先打开并等待成功,再测量;打开失败或请求取消时不继续测量。已打开的本地连接直接复用,服务模式沿用原流程。VID/光通量失败通常回复数值 0;光谱命令成功但无结果模型时也可能只有前缀,客户端需区分缺值和有效零值。本地结果使用此次返回模型,服务结果按 MasterId 查询。
D_<SN>.csv 使用 LUX 专用导出,沿用原列名和顺序。批次、色温、电参量、光谱采样等字段缺失或数值非有限时,单元格写 -1,实测零值照常写入。波长列按实际采样波长对应。色温不可用的原因可查看 Temperature Status。
VID/光通量测量后在后台访问输出目录并保存 CSV;共享盘等待期间界面保持响应,状态显示“正在保存结果”,请求仍忙碌,保存结束才回包。共享盘异常时可将“结果输出目录”改为可写的本地目录复测;后台保存不保证失联共享盘会在固定时间内返回,也不将尚未保存的结果提前报为成功。
错误与超时
| 响应或现象 | 含义与处理 |
|---|---|
No SN | 命令或 SN 为空;补齐请求,不启动测量 |
No right Code X0000 | 命令不以 T00 开头;核对协议模式与命令 |
No Dispatcher Hanle | 未找到文本处理器,保留宿主原错误拼写;核对项目加载和 handler 发现 |
H0321,SN001,00;FlowFailed:OverTime,Timeout; | Flow 失败信息追加在原前缀后;事件和参数由执行结果决定 |
H03AR02,SN001FlowFailed:Failed,detail; | 光学中心失败沿用专用前缀,不额外补分隔符 |
| 忙碌时无响应 | 新测量沿用原协议忽略,不返回 BUSY;握手仍可立即回复 |
客户端必须设置业务超时。超时后先查 Pro 执行状态、设备日志和结果记录,再决定重试;协议没有请求 ID 或跨重试去重保证。CSV 保存失败会记录日志,不能只凭 TCP 成功回复证明导出成功。
连接与异步边界
每个接受的测量命令固定自身的 SN、设备号、处理项和响应前缀,异步完成最多回包一次。LUX 测量与 JSON 的控制流程共用 SocketControl.Current.Stream;新 LUX 测量通过忙碌检查后才记录该连接,握手和被忽略的测量不接管旧任务连接。JSON 执行和推进命令沿用原连接更新规则,详见 Pro 连接说明。
最终发送时读取当前 Stream,失败记录日志、不自动补发;这不是按连接隔离的多站并发协议。关闭窗口会取消本窗口设备等待,不能假定取消一定产生测量回包。
验证与交付
本地构建见 ARVRPro 本地入口。
现场仍需串行验证握手、普通流程、H03AR、VID 和光通量,核对 CSV、测量值、Recipe 判定、失败回包、忙碌超时与断线恢复。真实设备与产线操作须在授权范围内执行;离线和回环测试不能替代业务交付验收。
