跳到正文
PreciSim
concepts

设备抽象

虚拟设备和真实设备实现同一套接口——这是「先在虚拟机台上跑通」能成立的前提。

一句话

上层代码不知道自己在跟虚拟设备还是真实设备说话。

这不是为了好看。它决定了三件事能不能成立:

  1. 没有硬件的人能不能完整跑通流程;
  2. 流程在虚拟设备上验证过之后,到现场还需不需要重写;
  3. 能不能在 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
这页有帮助吗?