操作说明字段
每项设备操作都应提供以下说明:参数字段
parameters 中的每个参数应分别说明:
参数约束既用于编译和仿真,也必须在设备动作前再次校验。参数之间存在关系时,还应说明跨字段约束,例如“总加液量不得超过目标容器剩余容量”“转速越高时允许的最大持续时间越短”。
调用时的操作字段
返回时的操作字段
填写示例
以加液操作为例,操作说明可以声明:操作标识为add_liquid;参数包括来源容器标识和加液体积;体积类型为数值、单位为毫升、允许范围为 0.05–0.8 mL;完成条件为设备确认液体已经加入且实际体积得到核验。调用时可以填写来源容器 source-01 和体积 0.5 mL。完成后的操作结果可以填写状态 succeeded、实际体积 0.498 mL、诊断为空。
以设定温度操作为例,可以声明目标温度、升温速率和稳定时间三个参数。目标温度可限制为 20–120 °C,升温速率可限制为 0.1–10 °C/min。完成后返回实际稳定温度、达到稳定状态的时间以及超调量;如果温度未在规定时间内进入允许偏差,则状态填写 failed,诊断说明超时和实际温度。
强制规则
- 操作参数必须声明类型、含义以及适用的范围、枚举或格式约束;
- 调用前必须同时校验对象状态、操作参数和系统条件;
- 返回结果必须反映设备实际执行情况,不得把计划参数直接当作实际结果;
- 失败、取消或结果未知时,不得报告预期成功状态;
- FSP 不规定操作在 HTTP、CLI、MCP、RPC 或 SDK 中的具体名称与路径。