知识库
显微系统的在线集成：SDK 与产线对接要确认什么
设备方提供 SDK 只是起点。真正决定项目能不能上线的是：变倍、对焦、采集、测量这四件事能不能被你的系统稳定调用。
SDK 能控制哪些动作
二次开发的价值在于把单机操作变成自动流程。通常需要能被程序控制的动作包括：变倍、自动对焦、图像采集、照明切换与测量分析。
选购时要逐项确认这些动作是否都开放了接口，只开放采集而变倍和对焦仍需人工的系统，在产线上意义有限。
还要确认 SDK 支持的语言与运行环境，避免出现与现有系统不兼容的情况。
控制粒度决定了能做出什么样的自动流程，这是评估 SDK 时最该看的部分。
如果 SDK 只支持拍照而不支持对焦与倍率控制，很多自动化设想根本无法实现，必须提前确认清楚。
把这几条判断固化成一张评估表，后续新增设备时可以直接复用，不必每次重新讨论。
建议在验收阶段用实际样品跑一轮完整流程，最能暴露参数表上看不出的问题。
数据怎么出
集成的核心是数据。需要明确能导出哪些内容：原始图像、测量数值、判定结论，以及对应的倍率与标定信息。
缺少倍率与标定信息的数据，在后续追溯时无法复现当时的测量条件。
还要确认导出格式能否被现有质量系统直接读取，否则中间还要做一层转换。
数据格式应在开发开始前定死，后期变更的代价通常远高于早期约定。
建议双方以一份样例文件作为确认依据，而不是只用文字描述字段含义。
样例文件还能让开发方在拿到硬件之前就先做离线联调。
建议在验收阶段用实际样品跑一轮完整流程，最能暴露参数表上看不出的问题。
条件记录得越完整，后续复现与追溯越容易，这也是内部评审最认可的一点。
与质量系统对接前要定死的四项
第一项是字段定义：每个测量项的名称、单位与精度位数要统一。
第二项是判定逻辑：合格与否由设备侧判定还是由上位系统判定，必须提前定死。
第三项是异常处理：对焦失败、采集超时、样品缺失时系统应如何处理。
第四项是留存期限：原始图像与测量数据的保存时长要符合质量体系要求。
四项中任何一项含糊都会导致开发反复，反复的次数往往比预估多得多。
建议在需求文档中以表格形式逐项列出，并经双方确认后再进入开发。
更换品种越频繁，自动化带来的收益越明显，这一点在多品种小批量车间尤其突出。
成本与性能的取舍建议写成书面结论，避免人员变动后重新争论。
条件记录得越完整，后续复现与追溯越容易，这也是内部评审最认可的一点。
联调成本最容易被低估
设备方提供接口只是第一步，真正耗时的是现场联调：字段对齐、异常重试、节拍匹配、日志排查。
这部分工作量常常超过设备本身的部署时间，在预算与排期里应单独列出。
建议在合同中写明联调支持的范围与期限，避免出现接口有但无人对接的僵局。
联调成本主要来自沟通往返与现场等待，而不是代码量，这一点在预算时经常被漏算。
降低成本最有效的办法是把接口样本数据提前准备好，让双方都能离线开发，只在最后做一次现场验证。
现场环境与实验室条件不同，最终判断应以现场实测结果为准。
更换品种越频繁，自动化带来的收益越明显，这一点在多品种小批量车间尤其突出。
成本与性能的取舍建议写成书面结论，避免人员变动后重新争论。
上线前的验证清单
建议至少跑四项验证：连续运行一个班次看稳定性；用已知不良样件验证检出能力；用标准件验证测量复现性；断网与恢复验证异常处理。
这四项跑通，系统才算具备上线条件。
验证报告应随设备一并归档，便于后续审计与问题追溯。
验证结果应形成书面记录，作为量产阶段的基线。
后续出现异常时可以与基线对比，快速判断是配置变更还是设备故障，避免互相推诿。
现场环境与实验室条件不同，最终判断应以现场实测结果为准。
排查顺序建议固定下来：先确认最简单的一项，再逐层深入，效率最高。
把判定标准写进作业指导书，可以让不同班次的操作人员得到一致的结论。
留档要求越早提出越好，后期补采集链路的代价通常高于一次到位。
相关产品
- PMS-MF6020 电动变倍自动对焦显微镜
- PMS-FocusX 激光自动对焦显微系统｜电动物镜切换与共轴激光对焦
- PMS-1209MGS 1200 万像素千兆网工业相机｜全局快门 1.1 英寸 CMOS
- 2D/3D 尺寸与轮廓测量全自动影像测量仪｜MetX 系列
常见问题
SDK 集成前要确认哪些能力
确认变倍、自动对焦、图像采集、照明切换与测量分析是否都开放接口，以及 SDK 支持的语言与运行环境是否与现有系统兼容。并把接口约定写进需求文档双方确认。
只开放采集接口够用吗
不够。若变倍与对焦仍需人工操作，系统在产线上只能半自动运行，节拍与一致性都难以保证，选购时应逐项确认动作是否开放。并把接口约定写进需求文档双方确认。
导出数据必须包含哪些信息
至少包含原始图像、测量数值、判定结论以及对应的倍率与标定信息。缺少倍率与标定信息的数据在追溯时无法复现测量条件。并把接口约定写进需求文档双方确认。
与质量系统对接最容易卡在哪
卡在字段定义与判定逻辑不统一。建议在开发前把测量项名称、单位、精度位数以及合格判定归属（设备侧还是上位系统）一次定死。并把接口约定写进需求文档双方确认。
联调成本为什么容易被低估
因为真正的耗时在字段对齐、异常重试、节拍匹配与日志排查，这部分工作量常超过设备部署本身，应在预算与排期中单独列出。并把接口约定写进需求文档双方确认。
上线前要做哪些验证
建议跑四项：连续运行一个班次的稳定性、用已知不良样件验证检出能力、用标准件验证测量复现性、断网恢复验证异常处理。并把接口约定写进需求文档双方确认。
相关阅读
把一个工件发给我们，我们告诉你该走哪条路
形貌问题最快的收敛方式是真工件，不是讨论。寄一件样品，附上图纸和你要判的高度特征，我们跑完把结果报给你 —— 包括哪些特征结论是「光学测不了」。我们不做「什么都能测」的承诺，只给可验证的结论。
邮件订阅
您将收到我们最新的动态资讯
