concepts
设备抽象
虚拟设备和真实设备实现同一套接口——这是「先在虚拟机台上跑通」能成立的前提。
一句话
上层代码不知道自己在跟虚拟设备还是真实设备说话。
这不是为了好看。它决定了三件事能不能成立:
- 没有硬件的人能不能完整跑通流程;
- 流程在虚拟设备上验证过之后,到现场还需不需要重写;
- 能不能在 CI 里跑端到端测试。
接口长什么样
每类设备一个接口,只暴露业务真正需要的能力,不暴露厂商 SDK 的细节。
所有设备接口都继承自 IDeviceConnection(名字、连接状态、连/断,含重连退避):
public interface IImagingDevice : IDeviceConnection
{
IReadOnlyList<string> CameraIds { get; }
Task<Frame> GrabAsync(string cameraId, CancellationToken ct = default);
Task SetExposureAsync(string cameraId, double us);
Task SetGainAsync(string cameraId, double db);
Task<(double ExposureUs, double GainDb)> GetSettingsAsync(string cameraId);
}
public interface IMotionDevice : IDeviceConnection
{
Task<AxisState> GetStateAsync(int axis); // 指令位置/回报位置/在动/使能/回零/限位/故障
Task ServoAsync(int axis, bool on);
Task HomeAsync(int axis, CancellationToken ct = default);
Task MoveAbsAsync(int axis, double mm, double velMmPerS, CancellationToken ct = default);
Task MoveRelAsync(int axis, double mm, double velMmPerS, CancellationToken ct = default);
Task MoveAbsMultiAsync(IReadOnlyList<int> axes, IReadOnlyList<double> mm,
double velMmPerS, CancellationToken ct = default);
Task StopAsync(int axis);
Task WaitDoneAsync(int axis, int timeoutMs, CancellationToken ct = default);
IAsyncEnumerable<IReadOnlyList<double>> PositionStream(CancellationToken ct);
}
public interface IIoDevice : IDeviceConnection
{
IReadOnlyList<IoPointInfo> Points { get; } // 点表:名称/方向/分组/平台/角色
// 读写按点位名,不按裸通道号
}一整套设备装在 IDeviceSet 里:Motion / Imaging / Io / ScanHead / Laser /
RangeFinder / Light。上层只认这个集合。
注意接口里没有的东西:没有 GetBaslerHandle(),没有 SendGCode(string),
没有任何「某一家厂商才有」的口子。一旦开了这种口子,上层就会开始依赖它,抽象就破了。
三个细节值得单独说:
AxisState回报的是「控制器回报位置」,不是真实位置。虚拟设备里两者故意不同 (差一个读数噪声和螺距误差)——要是相同,标定就会拟合出恒等变换,什么都标不出来。- IO 按点位名读写,界面完全由点表自动生成。加一个气缸是改点表,不是改界面。
- 取图是
Frame:8 bit 灰度 + 宽高 + 时间戳 + 相机 id,外加一个PrincipalPoint(画面中心,标定按 C4 拿它当参考)。
一台机器由配置拼出来
机器长什么样写在机台描述文件里(引擎包里带着 machines/demo-xy-galvo.json),
换机器只改这个文件,代码不动:
{
"name": "demo-xy-galvo",
"world": { "widthMm": 600, "heightMm": 400, "umPerPixel": 0.8 },
"axes": [
{ "name": "X", "index": 0, "minMm": -165, "maxMm": 165, "velocityMmPerS": 300,
"pitchErrorAmpMm": 0.0008, "pitchErrorPeriodMm": 50, "repeatabilityMm": 0.0002 },
{ "name": "Y", "index": 1, "minMm": -120, "maxMm": 120, "velocityMmPerS": 300, "...": "" },
{ "name": "Z", "index": 2, "minMm": 80, "maxMm": 140, "velocityMmPerS": 20, "...": "" }
],
"cameras": [
{ "name": "cam0", "width": 4096, "height": 3000,
"pixelSizeUm": 1.7236, // ★ 像素当量真值
"rotationDeg": -0.80, // ★ 安装角真值(符号极易反)
"workingDistanceMm": 110, "zMountOffsetMm": 2.347, // ★ 合焦 Z = 两者之和
"depthOfFieldMm": 0.17, "k1": 0.0, "k2": 0.0 }
],
"scanHeads": [
{ "name": "galvo0", "fieldSizeMm": 40,
"offsetXMm": 0.412, "offsetYMm": 55.180, // ★ 相机—执行器偏移
"scaleX": 1.0012, "scaleY": 0.9993, "k1": 1.8e-5, "skew": 3.0e-4 }
]
}带 ★ 的字段就是各条标定链要测出来的量,也就是自动评分的依据。
上位机侧只有 appsettings.json 里的一行 Device.Mode(Sim / Real)决定装哪套实现——
不用条件编译。
虚拟设备多「虚」
虚拟设备不是返回假数据的空壳,它按物理模型算:
| 设备 | 模拟了什么 |
|---|---|
| 相机 | 视场映射、径向畸变(k₁/k₂)、安装角、离焦高斯模糊、曝光/增益/光源亮度、高斯噪声 |
| 轴 | 点到点定位、软限位、回零、螺距周期误差、重复定位误差、读数噪声、急停 |
| 台面 | 倾斜与平面度起伏(影响离焦,所以影响成像清晰度) |
| IO | 点表 + 联动规则(A 变了、延时 t 后 B 变)+ 故障注入 |
| 振镜 | 场畸变(缩放/畸变/剪切)、相对相机的安装偏移 |
| 激光 | 光斑形貌(环形痕迹)、束腰与瑞利长度、功率/频率响应与噪声 |
没有模拟的:加减速曲线与 S 曲线、反向间隙、伺服整定与机械共振、衍射级别的 PSF。 这些对「学会标定链」没有帮助,加进来只会让模型更难讲清楚。
教学时最有用的用法是把某一项调大——比如把相机安装角从 −0.8° 调到 −5°, 再让新人去做一次像素当量标定,一眼就看清安装角到底在干什么。
具体模型写在物理与模型说明里。
什么不该进设备层
- 业务逻辑:「先吹气再拍照」属于工作流,不属于相机。
- 标定结果:标定属于「这台机器的当前状态」,存在标定库里,不在设备对象上。
- 重试策略:设备只如实报错,重试/跳过/中止由工作流统一决定。
这三条守住了,换设备才真的只是换配置。
最后更新: 2026/9/22
这页有帮助吗?