化学发光仪维护界面设计草图与功能说明
来源:文思海辉交付的”注册后优化”阶段维护界面设计文档(两份:0821 草图版 + 附功能说明版)。这是 UI 设计师(均强)出的界面草图配套说明,供软件方评审。文档性质为需求/设计讨论稿,内含大量待确认问题清单。
背景定位
- 项目:全自动化学发光免疫分析仪(YGSAutoFlowControl,i.MX6 + Qt)
- 阶段:注册后优化——维护/调试界面重构
- 涉及三大硬件区:样本试剂区、机械臂测试区、反应区
- 关联笔记:化学发光仪指令集协议与错误码体系-文思海辉调试记录、化学发光定量拟合算法体系-四参数直线对数指数二次多项式
一、样本试剂区维护功能(11 项)
单步调试动作清单(编号为文档原编号):
- TIP 架走到指定的行数位置
- 样本架走到指定的位置
- 取 TIP 时依次递增的距离,默认 9mm
- 样本架当前 1 号位置的调整(正负值偏移校正)
- 查询并显示八个稀释杯的有/无
- 查询样本架区所有光耦状态并显示(草图未列完整)
- 试剂仓走到指定的位置
- 试剂仓摇匀
- 试剂仓当前 1 号位置的调整(正负值偏移校正)
- 试剂仓温度的查询并显示
- 查询试剂仓区所有光耦状态并显示
- 附加:扫描试剂/样本并显示选中位的条码信息;样本架走到清洗液/底物位置
规则:所有动作最多 3 个参数;有参数则显示参数名+数据,无参数不显示。样本孔位、反应位置、试剂位均为 1-8。
二、机械臂测试区
- X/Z 轴:坐标输入(小数点前三位、后两位,单位 mm),实时显示当前位置(只读),X/Z 点动按钮,执行按选中档位速度。
- 孔位坐标下拉列表(18 个固定点位):TIP初始位、清洗液、底物、全血/质控、稀释杯架、试剂仓酶标/稀释液、试剂仓磁珠、清洗液1、R2试剂、反应仓全血、反应仓血清、反应仓酶标、反应仓磁珠、反应仓清洗液、反应仓底物、抛TIP位、反应仓清洗液1、反应仓R2。
- 高度参数表:
- 取液起始/结束高度:磁珠、酶标、稀释液、清洗液、底物、样本、稀释杯(7 类)
- 取 TIP 起始+结束高度;抛 TIP 只有结束高度;注液只有结束高度(无起始)
- 动作序列示例:
- 目标位置取 TIP:样本架走到指定位置 -> 机械臂走到 TIP 位 -> 取 TIP
- 吸液流程顺序:取样本 -> 取试剂 -> 吸液(取样本时样本架走到 1 号位,取试剂时试剂仓走到 1 号位,按吸液类别决定,机械臂再走到相应位置吸液)
- 抛 TIP:Z 轴归零 -> 走到抛 TIP 位 -> 抛 TIP
- 注液:机械臂走到盘片孔位注液
三、反应区
- 反应盘:输入步数执行转动;孔位步数保存(1 号位坐标只读显示);1-8 号孔相邻间隔步数可修改;反应盘点动按键。
- 盘片孔位下拉:全血、血清、磁珠、酶标、清洗液、底物、清洗液1、R2试剂、PMT位。
- PMT 侦测动作链:磁座 Off -> PMT 开 -> 静置 -> 反应盘转到选择孔位 -> PMT 侦测 -> PMT 关。门控时间/检测次数/静置时间可修改,仅侦测一个孔位。
- 磁座切换初始位置可输入可保存(6 位整数)。
- 离心:表格配置速度、加速度、时间,离心次数可输入(填 3 = 执行前三段离心)。
- 光耦状态:一键查询反应区所有光耦。
四、流程测试(多段流程拼接)
- 项目/流程两级模型:项目列表 -> 每个项目挂多条流程。
- 新增流程:输入名称->新增->按新增顺序进入下拉列表;选中流程后动作步骤显示在测试表中。
- 多段拼接:选中的流程按选择先后顺序排入列表,可单删(同步删除测试列表中的动作序列),“清空流程”清空当前选中全部。
- 序号自动生成(每次点击递增);保存按钮保存当前选中所有流程的动作序列+参数。
- 检测结果:有结果则显示光子数;若选了拟合曲线,追加显示浓度。
- 测试序列执行:按测试序列顺序串行执行(执行完 1 再执行 2);“所有项目同时做”被明确标注不可实现。
五、关键设计约定(实现时必须遵守)
- 两级保存语义:界面上所有”保存/设置”按键仅保存参数到 UI 层,不覆盖中位机数据;只有”执行保存所有参数”按键才真正覆盖中位机参数(该按键未画在草图上,可放三区任意空白位)。
- 单步动作 vs 联动动作:三区动作默认都是单步(只动一个部位);例外 5 个联动动作:抛TIP、目标位置取TIP、开始吸液、开始注液、PMT侦测。
- 光耦名称与长度->步数换算:医工所提供,文档要求直接联系医工所,草图上光耦未标全。
六、文档中的待确认问题清单(评审遗留)
- 哪些界面信息需要掉电保存?
- 数据类型/取值范围/精度:样本架与试剂仓 1 号位调整、取 TIP 递增距离、摇匀参数
- 稀释杯检测、光耦查询、温度查询硬件是否支持
- 吸液量/空气量/注液量取值范围与精度
- 盘片孔位是否默认 1 号位;ADP 初始化的作用
- 表格参数是否改为”表格只显示 + 弹窗设置”模式
- PMT 孔位下拉框数据类型/范围/精度;“选择的孔位”指反应盘孔位还是 PMT 孔位下拉框
- 是否需要”取消”按钮回滚新增/设置项目前状态;样本孔位/反应位置是否可重复选择
可行动点 / 知识提炼
- 该文档是理解 YGS 维护 UI 与中位机指令映射的钥匙:界面动作 = 指令集中单步指令的组合,5 个联动动作对应中位机复合指令。
- “UI 参数默认不写中位机、显式总保存才下发”是仪器软件安全的通用模式,可迁移到其他仪器 UI 设计。
- 高度参数(起始/结束)按液体类别 x 位置建模,取 TIP 有起始、抛 TIP/注液无起始——这类不对称性是机械臂时序调试的高频坑。