电机命令与位置读回
DeviceMotor 把独立电机服务接入设备资源体系;MQTTMotor 发送打开、移动、光圈移动、回原点和读位置请求,DisplayMotor 提供手动入口。这里描述的是客户端请求与回包处理,不是电机控制器的运动完成或安全保证。
移动和回原点会产生真实机械运动。执行前必须由现场操作者确认行程、方向、限位/急停、负载及危险区域,并取得动作授权。配置里有 MinPosition / MaxPosition 不代表手动发送路径已校验目标范围;当前 MQTTMotor 也没有独立的急停方法,Close 不能当作已验证的急停。位置异常不授权 AI 自动回零或试走。
配置、显示与持久化
ConfigMotor.MotorConfig 保存 MotorConfigBase 的通信、速度、加减速、回零和行程参数。设备设置采用事务式属性编辑,提交后调用设备 Save;数据库保存、远端重配与完成确认的公共边界见设备资源配置,不要把保存配置等同于远端已应用。
ConfigMotor.Position 是带 JsonIgnore 的运行期读回值,不是持久化目标。界面位置框绑定它;应用中保留的旧值不能证明当前物理位置。目标位置、绝对/相对模式则来自 DisplayMotor 当前控件。
手动操作
在设备控制区展开电机面板后,按以下顺序使用。开始运动前须满足前述现场条件。
- 点击“连接”。
Open成功回包后,按钮显示“关闭”;这表示客户端收到服务确认。 - 在移动输入框填写整数目标。勾选“绝对位置”发送绝对目标,未勾选发送相对位移,再点击“移动”。调整光圈使用另一输入框和“调整光圈”按钮。界面不指定控制器的位置单位,应按所接设备的配置和协议解释数值。
- 需要回零时使用“返回原点”。当前处理器也要求移动输入框能解析为整数,但不会把这个数字传给回零命令。
- 检查动作结果时另点“获取位置”,成功回包才更新只读的“当前位置”。移动、光圈或回零回包都不会自动执行此读回。
请求参数与响应
| 操作 | 发出的关键参数 | 本客户端收到 Code=0 后的处理 |
|---|---|---|
Open | 无显式设备参数;消息跟踪超时设为 1000 ms | 标记 DeviceStatus=Opened |
Close | 空参数;消息跟踪超时设为 1000 ms | 标记 DeviceStatus=Closed |
Move | nPosition、bAbs、dwTimeOut | 不更新位置,也不自动发 GetPosition |
MoveDiaphragm | dPosition、dwTimeOut | 不更新位置 |
GoHome | dwTimeOut | 没有专门的回包更新分支 |
GetPosition | dwTimeOut | 把 Data.nPosition 写入 Config.Position |
Move / MoveDiaphragm 签名虽然接受 dwTimeOut 实参,当前实现没有使用它;运动、回原点和读位置消息均使用 Config.MotorConfig.DwTimeOut(默认 5000),并非 HomeTimeout。这是发送给服务的参数;这些方法的本地回包等待使用 PublishAsyncClient 默认的 30000 ms。两种超时不能互相替代。
Move 的 API 默认绝对移动(IsbAbs=true),手动按钮则显式传入复选框状态。移动与回零入口使用 int.TryParse,光圈使用 double.TryParse;解析失败时直接返回,不产生本次请求记录。
回包、位置与失败分流
公共 MQTTServiceBase 按订阅主题和待处理 MsgID 关联请求记录,把 Code=0 标为 Success、其余代码标为 Fail。超时只结束本地追踪,不撤销已发出的动作,完整规则见MQTT 请求与回包。
位置/状态回填是另一层处理:MQTTMotor.ProcessingReceived 按 Code 和 EventName 更新,不再次校验 DeviceCode,也不要求仍有匹配的待处理记录。同一订阅主题上的迟到或其它设备消息可能触发更新;确认位置时应同时核对原始回包的设备身份和时间。成功回包本身不能证明电机已停稳或到位。
MQTTMotor 的附加处理在 Code=1 时把设备标为 Closed;其它非零代码不会在此处更新设备状态。不要因此把状态文字当作控制器真实电源或运动状态。
| 现象 | 无需运动即可先核对的证据 |
|---|---|
| 打不开或无回包 | 设备 Code、收发主题、通信配置、对应 MsgID 的失败码/超时 |
| 移动后位置未变 | 是否只有 Move 回包;只有 GetPosition 成功分支会更新界面位置 |
| 回原点按钮没有发消息 | 位置文本是否通过整数解析;是否真的产生本次 MsgID |
| 超时参数与预期不符 | 检查实际消息里的 dwTimeOut,不要只看调用实参或 HomeTimeout |
| 读回位置不可信 | 核对目标设备和最近读回;需要进一步硬件检查时单独取得现场授权 |
需要确认运动后位置时,读位置请求与运动请求应分别关联,不能以界面没刷新推断运动失败,也不能以成功回包推断到位。
Flow 不是手动按钮的复用
Engine/FlowEngineLib/MotorNode.cs 面向 Motor 服务,当前按运行类型发送焦距 Move 或光圈 MoveDiaphragm,使用自己的位置和绝对/相对参数。不要由手动服务存在 GoHome 推断该节点也提供回原点。
CamMotorNode 面向 Camera 服务,包含相机电机移动、光圈和自动对焦,是另一条设备路由。排查时先确定节点的服务类型、设备 Code 和实际载荷,再核对Flow 执行会话;不把“先手动移动一次”作为无需授权的排障步骤。
验证边界
在获授权的隔离现场核对控制器单位、方向、限位、回零、停止和到位行为。
